skillware 0.2.1__tar.gz → 0.2.2__tar.gz

{skillware-0.2.1 → skillware-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skillware
-Version: 0.2.1
+Version: 0.2.2
 Summary: A framework for modular, self-contained AI skills.
 Author-email: ARPA Hellenic Logic Systems <skillware-os@arpacorp.net>
 License: MIT License
@@ -79,7 +79,7 @@ Dynamic: license-file
 
 ## Mission
 
-The AI ecosystem is fragmented. Developers often re-invent tool definitions, system prompts, and safety rules for every project. **Skillware** supplies a standard to package capabilities into self-contained units that work across **Gemini**, **Claude**, **GPT**, and **Llama**.
+The AI ecosystem is fragmented. Developers often re-invent tool definitions, system prompts, and safety rules for every project. **Skillware** supplies a standard to package capabilities into self-contained units that work across **Gemini**, **Claude**, **Ollama**, **GPT**, and **Llama**.
 
 A **Skill** in this framework provides everything an Agent needs to master a domain:
 
@@ -94,26 +94,23 @@ This repository is organized into a core framework, a registry of skills, and do
 
 ```text
 Skillware/
+├── docs/                       # Comprehensive Documentation & Usage Guides
+├── examples/                   # Reference Implementations
+│   └── basic_agent.py          # Example showing SkillLoader integration
+├── skills/                     # Skill Registry
+│   └── category/               # Domain boundaries (e.g., finance)
+│       └── skill_name/         # The Skill bundle
+│           ├── manifest.yaml   # Definition, schema, and constitution
+│           ├── skill.py        # Executable Python logic
+│           └── instructions.md # Cognitive map for the LLM
 ├── skillware/                  # Core Framework Package
 │   └── core/
 │       ├── base_skill.py       # Abstract Base Class for skills
-│       ├── loader.py           # Universal Skill Loader & Model Adapter
-│       └── env.py              # Environment Management
-├── skills/                     # Skill Registry (Domain-driven)
-│   ├── category/               # e.g., finance, optimization, data_engineering
-│   │   └── skill_name/         # e.g., prompt_rewriter, wallet_screening
-├── templates/                  # New Skill Templates
-│   └── python_skill/           # Standard Python Skill Template
-├── examples/                   # Reference Implementations
-│   ├── gemini_wallet_check.py  # Google Gemini Integration
-│   ├── claude_wallet_check.py  # Anthropic Claude Integration
-│   ├── gemini_pdf_form_filler.py
-│   └── claude_pdf_form_filler.py
-├── docs/                       # Comprehensive Documentation
-│   ├── introduction.md         # Philosophy & Design
-│   ├── usage/                  # Integration Guides
-│   └── skills/                 # Skill Reference Cards
-└── COMPARISON.md               # Comparison vs. Anthropic Skills / MCP
+│       ├── env.py              # Environment Management
+│       └── loader.py           # Universal Skill Loader & Model Adapter
+├── templates/                  # Boilerplate templates for new skills
+│   └── python_skill/           # Standard template with required files
+└── tests/                      # Automated test suite
 ```
 
 ## Quick Start
@@ -177,19 +174,24 @@ print(response.text)
 *   **[Core Logic & Philosophy](docs/introduction.md)**: Details on how Skillware decouples Logic, Cognition, and Governance.
 *   **[Usage Guide: Gemini](docs/usage/gemini.md)**: Integration with Google's GenAI SDK.
 *   **[Usage Guide: Claude](docs/usage/claude.md)**: Integration with Anthropic's SDK.
+*   **[Usage Guide: Ollama](docs/usage/ollama.md)**: Native integration for local models via Ollama.
 *   **[Skill Library](docs/skills/README.md)**: Available capabilities.
 
 ## Contributing
 
 We are building the "App Store" for Agents and require professional, robust, and safe skills.
 
-Please read **[CONTRIBUTING.md](CONTRIBUTING.md)** for guidelines on folder structure, manifest schemas, and safety constitutions.
+We actively encourage both humans and autonomous agents to contribute to this repository!
+
+* Please read our **[Agent Code of Conduct](CODE_OF_CONDUCT.md)** which outlines our strict expectations for deterministic outputs, zero LLM code generation, and safety boundaries.
+* When submitting skills, our new **Agent-Friendly Pull Request Template** provides a checklist to ensure your logic aligns natively with `loader.py` and `base_skill.py`.
+* Please also review **[CONTRIBUTING.md](CONTRIBUTING.md)** for detailed guidelines on folder structure and schema definitions.
 
 ## Comparison
 
 Skillware differs from the Model Context Protocol (MCP) or Anthropic's Skills repository in the following ways:
 
-*   **Model Agnostic**: Native adapters for Gemini, Claude, and OpenAI.
+*   **Model Agnostic**: Native adapters for Gemini, Claude, Ollama, and OpenAI.
 *   **Code-First**: Skills are executable Python packages, not just server specs.
 *   **Runtime-Focused**: Provides tools for the application, not just recipes for an IDE.
 

{skillware-0.2.1 → skillware-0.2.2}/README.md

@@ -32,7 +32,7 @@
 
 ## Mission
 
-The AI ecosystem is fragmented. Developers often re-invent tool definitions, system prompts, and safety rules for every project. **Skillware** supplies a standard to package capabilities into self-contained units that work across **Gemini**, **Claude**, **GPT**, and **Llama**.
+The AI ecosystem is fragmented. Developers often re-invent tool definitions, system prompts, and safety rules for every project. **Skillware** supplies a standard to package capabilities into self-contained units that work across **Gemini**, **Claude**, **Ollama**, **GPT**, and **Llama**.
 
 A **Skill** in this framework provides everything an Agent needs to master a domain:
 
@@ -47,26 +47,23 @@ This repository is organized into a core framework, a registry of skills, and do
 
 ```text
 Skillware/
+├── docs/                       # Comprehensive Documentation & Usage Guides
+├── examples/                   # Reference Implementations
+│   └── basic_agent.py          # Example showing SkillLoader integration
+├── skills/                     # Skill Registry
+│   └── category/               # Domain boundaries (e.g., finance)
+│       └── skill_name/         # The Skill bundle
+│           ├── manifest.yaml   # Definition, schema, and constitution
+│           ├── skill.py        # Executable Python logic
+│           └── instructions.md # Cognitive map for the LLM
 ├── skillware/                  # Core Framework Package
 │   └── core/
 │       ├── base_skill.py       # Abstract Base Class for skills
-│       ├── loader.py           # Universal Skill Loader & Model Adapter
-│       └── env.py              # Environment Management
-├── skills/                     # Skill Registry (Domain-driven)
-│   ├── category/               # e.g., finance, optimization, data_engineering
-│   │   └── skill_name/         # e.g., prompt_rewriter, wallet_screening
-├── templates/                  # New Skill Templates
-│   └── python_skill/           # Standard Python Skill Template
-├── examples/                   # Reference Implementations
-│   ├── gemini_wallet_check.py  # Google Gemini Integration
-│   ├── claude_wallet_check.py  # Anthropic Claude Integration
-│   ├── gemini_pdf_form_filler.py
-│   └── claude_pdf_form_filler.py
-├── docs/                       # Comprehensive Documentation
-│   ├── introduction.md         # Philosophy & Design
-│   ├── usage/                  # Integration Guides
-│   └── skills/                 # Skill Reference Cards
-└── COMPARISON.md               # Comparison vs. Anthropic Skills / MCP
+│       ├── env.py              # Environment Management
+│       └── loader.py           # Universal Skill Loader & Model Adapter
+├── templates/                  # Boilerplate templates for new skills
+│   └── python_skill/           # Standard template with required files
+└── tests/                      # Automated test suite
 ```
 
 ## Quick Start
@@ -130,19 +127,24 @@ print(response.text)
 *   **[Core Logic & Philosophy](docs/introduction.md)**: Details on how Skillware decouples Logic, Cognition, and Governance.
 *   **[Usage Guide: Gemini](docs/usage/gemini.md)**: Integration with Google's GenAI SDK.
 *   **[Usage Guide: Claude](docs/usage/claude.md)**: Integration with Anthropic's SDK.
+*   **[Usage Guide: Ollama](docs/usage/ollama.md)**: Native integration for local models via Ollama.
 *   **[Skill Library](docs/skills/README.md)**: Available capabilities.
 
 ## Contributing
 
 We are building the "App Store" for Agents and require professional, robust, and safe skills.
 
-Please read **[CONTRIBUTING.md](CONTRIBUTING.md)** for guidelines on folder structure, manifest schemas, and safety constitutions.
+We actively encourage both humans and autonomous agents to contribute to this repository!
+
+* Please read our **[Agent Code of Conduct](CODE_OF_CONDUCT.md)** which outlines our strict expectations for deterministic outputs, zero LLM code generation, and safety boundaries.
+* When submitting skills, our new **Agent-Friendly Pull Request Template** provides a checklist to ensure your logic aligns natively with `loader.py` and `base_skill.py`.
+* Please also review **[CONTRIBUTING.md](CONTRIBUTING.md)** for detailed guidelines on folder structure and schema definitions.
 
 ## Comparison
 
 Skillware differs from the Model Context Protocol (MCP) or Anthropic's Skills repository in the following ways:
 
-*   **Model Agnostic**: Native adapters for Gemini, Claude, and OpenAI.
+*   **Model Agnostic**: Native adapters for Gemini, Claude, Ollama, and OpenAI.
 *   **Code-First**: Skills are executable Python packages, not just server specs.
 *   **Runtime-Focused**: Provides tools for the application, not just recipes for an IDE.
 

{skillware-0.2.1 → skillware-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "skillware"
-version = "0.2.1"
+version = "0.2.2"
 description = "A framework for modular, self-contained AI skills."
 readme = "README.md"
 authors = [

skillware-0.2.2/skills/data_engineering/synthetic_generator/__init__.py

@@ -0,0 +1,3 @@
+from .skill import SyntheticGeneratorSkill
+
+__all__ = ["SyntheticGeneratorSkill"]

skillware-0.2.2/skills/data_engineering/synthetic_generator/skill.py

@@ -0,0 +1,157 @@
+import os
+import zlib
+import json
+
+from typing import Dict, Any
+
+from skillware.core.base_skill import BaseSkill
+
+
+class SyntheticGeneratorSkill(BaseSkill):
+    """
+    A skill that generates high-entropy synthetic data using internal LLMs,
+    and validates the generated text with zlib-based entropy scoring.
+    """
+
+    @property
+    def manifest(self) -> Dict[str, Any]:
+        manifest_path = os.path.join(os.path.dirname(__file__), "manifest.yaml")
+        if os.path.exists(manifest_path):
+            import yaml
+            with open(manifest_path, "r", encoding="utf-8") as f:
+                return yaml.safe_load(f)
+        return {}
+
+    def _calculate_entropy_score(self, text: str) -> float:
+        """
+        Calculates a heuristic entropy score using zlib compression ratio.
+        Higher score = less compressible = higher entropy.
+        """
+        if not text:
+            return 0.0
+        encoded = text.encode("utf-8")
+        compressed = zlib.compress(encoded)
+        ratio = len(compressed) / len(encoded)
+        # Scaled for readability
+        return round(min(ratio * 1.5, 1.0), 3)
+
+    def _call_gemini(
+        self, prompt: str, temperature: float, model_name: str
+    ) -> str:
+        import google.generativeai as genai
+        api_key = (
+            self.config.get("GOOGLE_API_KEY")
+            or os.environ.get("GOOGLE_API_KEY")
+        )
+        if api_key:
+            genai.configure(api_key=api_key)
+        model = genai.GenerativeModel(model_name)
+        response = model.generate_content(
+            prompt,
+            generation_config=genai.types.GenerationConfig(
+                temperature=temperature
+            )
+        )
+        return response.text
+
+    def _call_anthropic(
+        self, prompt: str, temperature: float, model_name: str
+    ) -> str:
+        import anthropic
+        api_key = (
+            self.config.get("ANTHROPIC_API_KEY")
+            or os.environ.get("ANTHROPIC_API_KEY")
+        )
+        client = anthropic.Anthropic(api_key=api_key)
+        message = client.messages.create(
+            model=model_name,
+            max_tokens=4096,
+            temperature=temperature,
+            messages=[{"role": "user", "content": prompt}]
+        )
+        return message.content[0].text
+
+    def _call_ollama(
+        self, prompt: str, temperature: float, model_name: str
+    ) -> str:
+        import ollama
+        response = ollama.chat(
+            model=model_name,
+            messages=[{"role": "user", "content": prompt}],
+            options={"temperature": temperature}
+        )
+        return response.get("message", {}).get("content", "")
+
+    def execute(self, params: Dict[str, Any]) -> Any:
+        domain = params.get("domain")
+        num_samples = params.get("num_samples")
+        temperature = float(params.get("entropy_temperature", 0.8))
+        diversity_prompt = params.get("diversity_prompt")
+
+        provider = params.get("model_provider", "ollama").lower()
+        model_name = params.get("model_name")
+
+        if not model_name:
+            if provider == "ollama":
+                model_name = "llama3"
+            elif provider == "gemini":
+                model_name = "gemini-1.5-flash"
+            elif provider == "anthropic":
+                model_name = "claude-3-haiku-20240307"
+
+        system_prompt = (
+            f"You are a generator for domain: '{domain}'.\n"
+            f"Output exactly {num_samples} samples in a JSON array.\n"
+            f"Constraint: {diversity_prompt}\n"
+            "Return valid JSON array. Keys: instruction, input, output."
+        )
+
+        try:
+            if provider == "gemini":
+                raw_text = self._call_gemini(
+                    system_prompt, temperature, model_name
+                )
+            elif provider == "anthropic":
+                raw_text = self._call_anthropic(
+                    system_prompt, temperature, model_name
+                )
+            else:
+                raw_text = self._call_ollama(
+                    system_prompt, temperature, model_name
+                )
+        except Exception as e:
+            return {
+                "status": "error",
+                "message": f"LLM Call Failed via {provider}: {str(e)}"
+            }
+
+        samples = []
+        try:
+            cleaned = raw_text.strip()
+            if "```json" in cleaned:
+                cleaned = cleaned.split("```json")[-1].split("```")[0].strip()
+            elif "```" in cleaned:
+                cleaned = cleaned.split("```")[-1].split("```")[0].strip()
+
+            parsed = json.loads(cleaned)
+            if isinstance(parsed, list):
+                samples = parsed
+            else:
+                samples = [parsed]
+        except Exception as e:
+            return {
+                "status": "error",
+                "message": f"Parsing failed: {e}",
+                "raw_output": raw_text
+            }
+
+        all_text = " ".join([str(s) for s in samples])
+        score = self._calculate_entropy_score(all_text)
+
+        return {
+            "samples": samples,
+            "entropy_score": score,
+            "status": "success",
+            "provider_used": provider,
+            "samples_generated": len(samples)
+        }

{skillware-0.2.1 → skillware-0.2.2}/skillware/core/loader.py

@@ -125,3 +125,31 @@ class SkillLoader:
         parameters = manifest.get("parameters", {})
 
         return {"name": name, "description": description, "input_schema": parameters}
+
+    @staticmethod
+    def to_ollama_prompt(skill_bundle: Dict[str, Any]) -> str:
+        """
+        Converts a skill manifest to a textual description suitable for a system prompt.
+        This allows older models (like Llama 3) running via Ollama without native tool-calling
+        API support to understand and utilize the skill via text generation.
+        """
+        manifest = skill_bundle.get("manifest", {})
+        name = manifest.get("name", "unknown_tool")
+        description = manifest.get("description", "").strip()
+        parameters = manifest.get("parameters", {})
+
+        prompt = f"### Tool: `{name}`\n"
+        prompt += f"**Description:** {description}\n"
+        prompt += "**Parameters:**\n"
+
+        props = parameters.get("properties", {})
+        required = parameters.get("required", [])
+
+        if not props:
+            prompt += "- None\n"
+        else:
+            for k, v in props.items():
+                req_str = "Required" if k in required else "Optional"
+                prompt += f"- `{k}` ({v.get('type', 'any')}): {v.get('description', '')} [{req_str}]\n"
+
+        return prompt

{skillware-0.2.1 → skillware-0.2.2}/skillware.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skillware
-Version: 0.2.1
+Version: 0.2.2
 Summary: A framework for modular, self-contained AI skills.
 Author-email: ARPA Hellenic Logic Systems <skillware-os@arpacorp.net>
 License: MIT License
@@ -79,7 +79,7 @@ Dynamic: license-file
 
 ## Mission
 
-The AI ecosystem is fragmented. Developers often re-invent tool definitions, system prompts, and safety rules for every project. **Skillware** supplies a standard to package capabilities into self-contained units that work across **Gemini**, **Claude**, **GPT**, and **Llama**.
+The AI ecosystem is fragmented. Developers often re-invent tool definitions, system prompts, and safety rules for every project. **Skillware** supplies a standard to package capabilities into self-contained units that work across **Gemini**, **Claude**, **Ollama**, **GPT**, and **Llama**.
 
 A **Skill** in this framework provides everything an Agent needs to master a domain:
 
@@ -94,26 +94,23 @@ This repository is organized into a core framework, a registry of skills, and do
 
 ```text
 Skillware/
+├── docs/                       # Comprehensive Documentation & Usage Guides
+├── examples/                   # Reference Implementations
+│   └── basic_agent.py          # Example showing SkillLoader integration
+├── skills/                     # Skill Registry
+│   └── category/               # Domain boundaries (e.g., finance)
+│       └── skill_name/         # The Skill bundle
+│           ├── manifest.yaml   # Definition, schema, and constitution
+│           ├── skill.py        # Executable Python logic
+│           └── instructions.md # Cognitive map for the LLM
 ├── skillware/                  # Core Framework Package
 │   └── core/
 │       ├── base_skill.py       # Abstract Base Class for skills
-│       ├── loader.py           # Universal Skill Loader & Model Adapter
-│       └── env.py              # Environment Management
-├── skills/                     # Skill Registry (Domain-driven)
-│   ├── category/               # e.g., finance, optimization, data_engineering
-│   │   └── skill_name/         # e.g., prompt_rewriter, wallet_screening
-├── templates/                  # New Skill Templates
-│   └── python_skill/           # Standard Python Skill Template
-├── examples/                   # Reference Implementations
-│   ├── gemini_wallet_check.py  # Google Gemini Integration
-│   ├── claude_wallet_check.py  # Anthropic Claude Integration
-│   ├── gemini_pdf_form_filler.py
-│   └── claude_pdf_form_filler.py
-├── docs/                       # Comprehensive Documentation
-│   ├── introduction.md         # Philosophy & Design
-│   ├── usage/                  # Integration Guides
-│   └── skills/                 # Skill Reference Cards
-└── COMPARISON.md               # Comparison vs. Anthropic Skills / MCP
+│       ├── env.py              # Environment Management
+│       └── loader.py           # Universal Skill Loader & Model Adapter
+├── templates/                  # Boilerplate templates for new skills
+│   └── python_skill/           # Standard template with required files
+└── tests/                      # Automated test suite
 ```
 
 ## Quick Start
@@ -177,19 +174,24 @@ print(response.text)
 *   **[Core Logic & Philosophy](docs/introduction.md)**: Details on how Skillware decouples Logic, Cognition, and Governance.
 *   **[Usage Guide: Gemini](docs/usage/gemini.md)**: Integration with Google's GenAI SDK.
 *   **[Usage Guide: Claude](docs/usage/claude.md)**: Integration with Anthropic's SDK.
+*   **[Usage Guide: Ollama](docs/usage/ollama.md)**: Native integration for local models via Ollama.
 *   **[Skill Library](docs/skills/README.md)**: Available capabilities.
 
 ## Contributing
 
 We are building the "App Store" for Agents and require professional, robust, and safe skills.
 
-Please read **[CONTRIBUTING.md](CONTRIBUTING.md)** for guidelines on folder structure, manifest schemas, and safety constitutions.
+We actively encourage both humans and autonomous agents to contribute to this repository!
+
+* Please read our **[Agent Code of Conduct](CODE_OF_CONDUCT.md)** which outlines our strict expectations for deterministic outputs, zero LLM code generation, and safety boundaries.
+* When submitting skills, our new **Agent-Friendly Pull Request Template** provides a checklist to ensure your logic aligns natively with `loader.py` and `base_skill.py`.
+* Please also review **[CONTRIBUTING.md](CONTRIBUTING.md)** for detailed guidelines on folder structure and schema definitions.
 
 ## Comparison
 
 Skillware differs from the Model Context Protocol (MCP) or Anthropic's Skills repository in the following ways:
 
-*   **Model Agnostic**: Native adapters for Gemini, Claude, and OpenAI.
+*   **Model Agnostic**: Native adapters for Gemini, Claude, Ollama, and OpenAI.
 *   **Code-First**: Skills are executable Python packages, not just server specs.
 *   **Runtime-Focused**: Provides tools for the application, not just recipes for an IDE.
 

{skillware-0.2.1 → skillware-0.2.2}/skillware.egg-info/SOURCES.txt

@@ -1,6 +1,8 @@
 LICENSE
 README.md
 pyproject.toml
+skills/data_engineering/synthetic_generator/__init__.py
+skills/data_engineering/synthetic_generator/skill.py
 skills/finance/wallet_screening/__init__.py
 skills/finance/wallet_screening/skill.py
 skills/finance/wallet_screening/maintenance/normalization_tool.py
@@ -18,4 +20,5 @@ skillware.egg-info/top_level.txt
 skillware/core/__init__.py
 skillware/core/base_skill.py
 skillware/core/env.py
-skillware/core/loader.py
+skillware/core/loader.py
+tests/test_loader.py

skillware-0.2.2/tests/test_loader.py

@@ -0,0 +1,63 @@
+import pytest
+from skillware.core.loader import SkillLoader
+
+
+def test_load_skill_not_found():
+    with pytest.raises(FileNotFoundError):
+        SkillLoader.load_skill("nonexistent_skill_path_12345")
+
+
+def test_to_ollama_prompt():
+    dummy_bundle = {
+        "manifest": {
+            "name": "test_ollama_skill",
+            "description": "A very useful test skill.",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "arg1": {"type": "string", "description": "The first arg"}
+                },
+                "required": ["arg1"]
+            }
+        }
+    }
+
+    prompt = SkillLoader.to_ollama_prompt(dummy_bundle)
+    assert "### Tool: `test_ollama_skill`" in prompt
+    assert "**Description:** A very useful test skill." in prompt
+    assert "- `arg1` (string): The first arg [Required]" in prompt
+
+
+def test_to_gemini_tool():
+    dummy_bundle = {
+        "manifest": {
+            "name": "test_gemini_skill",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "param1": {"type": "string"}
+                }
+            }
+        }
+    }
+    tool = SkillLoader.to_gemini_tool(dummy_bundle)
+    assert tool["name"] == "test_gemini_skill"
+    # Gemini requires UPPERCASE types for Protobufs
+    assert tool["parameters"]["type"] == "OBJECT"
+    assert tool["parameters"]["properties"]["param1"]["type"] == "STRING"
+
+
+def test_to_claude_tool():
+    dummy_bundle = {
+        "manifest": {
+            "name": "test_claude_skill",
+            "description": "desc",
+            "parameters": {
+                "type": "object",
+                "properties": {"arg_claude": {"type": "string"}}
+            }
+        }
+    }
+    tool = SkillLoader.to_claude_tool(dummy_bundle)
+    assert tool["name"] == "test_claude_skill"
+    assert tool["input_schema"]["type"] == "object"