agent-skill-foundry 0.1.0__tar.gz

agent_skill_foundry-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+.env
+*.env
+.DS_Store
+requirements.md
+context.md

agent_skill_foundry-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sanath Goutham
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agent_skill_foundry-0.1.0/PKG-INFO

@@ -0,0 +1,50 @@
+Metadata-Version: 2.4
+Name: agent-skill-foundry
+Version: 0.1.0
+Summary: A Python framework for managing reusable AI skills throughout their lifecycle.
+Project-URL: Homepage, https://github.com/lancer59/agent-skill-foundry
+Project-URL: Repository, https://github.com/lancer59/agent-skill-foundry
+Project-URL: Issues, https://github.com/lancer59/agent-skill-foundry/issues
+Author: Sanath Goutham
+License: MIT
+License-File: LICENSE
+Keywords: agent-skill-foundry,agentic-ai,agents,ai,llm,skill-management,skills
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2.0
+Provides-Extra: all
+Requires-Dist: httpx>=0.25; extra == 'all'
+Requires-Dist: openai>=1.0; extra == 'all'
+Provides-Extra: ollama
+Requires-Dist: httpx>=0.25; extra == 'ollama'
+Provides-Extra: openai
+Requires-Dist: openai>=1.0; extra == 'openai'
+Description-Content-Type: text/markdown
+
+# Agent Skill Foundry
+
+> ⚠️ **This project is currently under active development. APIs may change without notice.**
+
+**Agent Skill Foundry (ASF)** is an open-source Python framework for managing reusable AI skills throughout their lifecycle — acquisition, validation, storage, retrieval, evolution, and governance.
+
+More documentation and features coming soon.
+
+---
+
+## Installation
+
+```bash
+pip install agent-skill-foundry
+```
+
+## License
+
+MIT

agent_skill_foundry-0.1.0/README.md

@@ -0,0 +1,19 @@
+# Agent Skill Foundry
+
+> ⚠️ **This project is currently under active development. APIs may change without notice.**
+
+**Agent Skill Foundry (ASF)** is an open-source Python framework for managing reusable AI skills throughout their lifecycle — acquisition, validation, storage, retrieval, evolution, and governance.
+
+More documentation and features coming soon.
+
+---
+
+## Installation
+
+```bash
+pip install agent-skill-foundry
+```
+
+## License
+
+MIT

agent_skill_foundry-0.1.0/agent_skill_foundry/__init__.py

@@ -0,0 +1,8 @@
+"""Agent Skill Foundry — reusable AI skill lifecycle management."""
+
+from agent_skill_foundry.core import AgentSkillFoundry
+from agent_skill_foundry.models.skill import Skill
+from agent_skill_foundry.providers.base import LLMProvider
+
+__version__ = "0.1.0"
+__all__ = ["AgentSkillFoundry", "Skill", "LLMProvider"]

agent_skill_foundry-0.1.0/agent_skill_foundry/core.py

@@ -0,0 +1,105 @@
+"""Core AgentSkillFoundry class."""
+
+from __future__ import annotations
+
+import json
+import re
+from typing import Literal
+
+from agent_skill_foundry.models.skill import Skill
+from agent_skill_foundry.providers.base import LLMProvider
+
+_SKILL_PROMPT = """\
+You are an AI skill designer. Given a task description, produce a JSON object \
+that defines a reusable AI skill.
+
+Task description: {description}
+
+Respond with ONLY a valid JSON object — no markdown fences, no extra text — \
+with exactly these keys:
+{{
+  "name": "<short human-readable name>",
+  "instructions": "<step-by-step instructions an AI agent should follow>",
+  "tags": ["<tag1>", "<tag2>", ...],
+  "category": "<single category word>"
+}}
+"""
+
+
+class AgentSkillFoundry:
+    """Entry point for the Agent Skill Foundry framework."""
+
+    def __init__(
+        self,
+        provider: Literal["openai", "ollama"] | LLMProvider = "openai",
+        *,
+        api_key: str | None = None,
+        model: str | None = None,
+        ollama_base_url: str = "http://localhost:11434",
+    ) -> None:
+        """
+        Initialise ASF with an LLM provider.
+
+        Args:
+            provider: Either a provider name string ("openai" | "ollama") or a
+                      custom LLMProvider instance.
+            api_key:  OpenAI API key. Falls back to the OPENAI_API_KEY env var.
+            model:    Override the default model for the chosen provider.
+            ollama_base_url: Base URL for a local Ollama instance.
+        """
+        if isinstance(provider, LLMProvider):
+            self._provider = provider
+        elif provider == "openai":
+            from agent_skill_foundry.providers.openai import OpenAIProvider
+
+            self._provider: LLMProvider = OpenAIProvider(
+                api_key=api_key,
+                model=model or "gpt-4o-mini",
+            )
+        elif provider == "ollama":
+            from agent_skill_foundry.providers.ollama import OllamaProvider
+
+            self._provider = OllamaProvider(
+                model=model or "llama3",
+                base_url=ollama_base_url,
+            )
+        else:
+            raise ValueError(
+                f"Unknown provider '{provider}'. "
+                "Use 'openai', 'ollama', or pass a custom LLMProvider instance."
+            )
+
+    def create_skill(self, description: str) -> Skill:
+        """
+        Create a Skill from a natural language description.
+
+        The LLM infers the name, instructions, tags, and category.
+
+        Args:
+            description: What the skill should do.
+
+        Returns:
+            A populated Skill object.
+        """
+        prompt = _SKILL_PROMPT.format(description=description)
+        raw = self._provider.complete(prompt)
+
+        # Strip accidental markdown fences if the model adds them anyway
+        raw = re.sub(r"^```(?:json)?\s*", "", raw.strip())
+        raw = re.sub(r"\s*```$", "", raw.strip())
+
+        try:
+            data = json.loads(raw)
+        except json.JSONDecodeError as e:
+            raise ValueError(
+                f"LLM returned invalid JSON for skill creation.\n"
+                f"Raw response:\n{raw}"
+            ) from e
+
+        return Skill(
+            name=data.get("name", "Unnamed Skill"),
+            description=description,
+            instructions=data.get("instructions", ""),
+            tags=data.get("tags", []),
+            category=data.get("category", "general"),
+        )

agent_skill_foundry-0.1.0/agent_skill_foundry/models/__init__.py

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

agent_skill_foundry-0.1.0/agent_skill_foundry/models/skill.py

@@ -0,0 +1,26 @@
+"""Skill data model."""
+
+from __future__ import annotations
+
+import uuid
+from datetime import datetime, timezone
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+
+class Skill(BaseModel):
+    """A reusable AI skill."""
+
+    skill_id: str = Field(default_factory=lambda: str(uuid.uuid4()))
+    name: str
+    description: str
+    version: str = "1.0.0"
+    instructions: str
+    tags: list[str] = Field(default_factory=list)
+    category: str = "general"
+    created_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
+
+    def to_dict(self) -> dict[str, Any]:
+        """Serialize the skill to a JSON-compatible dict."""
+        return self.model_dump(mode="json")

agent_skill_foundry-0.1.0/agent_skill_foundry/providers/__init__.py

@@ -0,0 +1,5 @@
+from agent_skill_foundry.providers.base import LLMProvider
+from agent_skill_foundry.providers.ollama import OllamaProvider
+from agent_skill_foundry.providers.openai import OpenAIProvider
+
+__all__ = ["LLMProvider", "OpenAIProvider", "OllamaProvider"]

agent_skill_foundry-0.1.0/agent_skill_foundry/providers/base.py

@@ -0,0 +1,14 @@
+"""Abstract base class for LLM providers."""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+
+
+class LLMProvider(ABC):
+    """Interface every LLM provider must implement."""
+
+    @abstractmethod
+    def complete(self, prompt: str) -> str:
+        """Send a prompt and return the text response."""
+        ...

agent_skill_foundry-0.1.0/agent_skill_foundry/providers/ollama.py

@@ -0,0 +1,36 @@
+"""Ollama LLM provider."""
+
+from __future__ import annotations
+
+from agent_skill_foundry.providers.base import LLMProvider
+
+
+class OllamaProvider(LLMProvider):
+    """LLM provider backed by a local Ollama instance."""
+
+    def __init__(
+        self,
+        model: str = "llama3",
+        base_url: str = "http://localhost:11434",
+    ) -> None:
+        try:
+            import httpx
+        except ImportError as e:
+            raise ImportError(
+                "httpx package is required for the Ollama provider. "
+                "Install it with: pip install httpx"
+            ) from e
+
+        self._model = model
+        self._base_url = base_url.rstrip("/")
+
+    def complete(self, prompt: str) -> str:
+        import httpx
+
+        response = httpx.post(
+            f"{self._base_url}/api/generate",
+            json={"model": self._model, "prompt": prompt, "stream": False},
+            timeout=120,
+        )
+        response.raise_for_status()
+        return response.json().get("response", "")

agent_skill_foundry-0.1.0/agent_skill_foundry/providers/openai.py

@@ -0,0 +1,31 @@
+"""OpenAI LLM provider."""
+
+from __future__ import annotations
+
+import os
+
+from agent_skill_foundry.providers.base import LLMProvider
+
+
+class OpenAIProvider(LLMProvider):
+    """LLM provider backed by the OpenAI API."""
+
+    def __init__(self, api_key: str | None = None, model: str = "gpt-4o-mini") -> None:
+        try:
+            from openai import OpenAI
+        except ImportError as e:
+            raise ImportError(
+                "openai package is required for the OpenAI provider. "
+                "Install it with: pip install openai"
+            ) from e
+
+        self._model = model
+        self._client = OpenAI(api_key=api_key or os.environ.get("OPENAI_API_KEY"))
+
+    def complete(self, prompt: str) -> str:
+        response = self._client.chat.completions.create(
+            model=self._model,
+            messages=[{"role": "user", "content": prompt}],
+            temperature=0.3,
+        )
+        return response.choices[0].message.content or ""

agent_skill_foundry-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agent-skill-foundry"
+version = "0.1.0"
+description = "A Python framework for managing reusable AI skills throughout their lifecycle."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [
+    { name = "Sanath Goutham" }
+]
+keywords = [
+    "ai", "agents", "skills", "llm", "agentic-ai",
+    "skill-management", "agent-skill-foundry"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "pydantic>=2.0",
+]
+
+[project.optional-dependencies]
+openai = ["openai>=1.0"]
+ollama = ["httpx>=0.25"]
+all = ["openai>=1.0", "httpx>=0.25"]
+
+[project.urls]
+Homepage = "https://github.com/lancer59/agent-skill-foundry"
+Repository = "https://github.com/lancer59/agent-skill-foundry"
+Issues = "https://github.com/lancer59/agent-skill-foundry/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["agent_skill_foundry"]