skilllite 0.1.0__py3-none-any.whl

skilllite/validation.py

@@ -0,0 +1,137 @@
+"""
+Validation utilities for Agent Skills specification.
+
+This module provides validation functions for skill names and descriptions
+according to the Skills specification.
+"""
+
+import re
+import warnings
+from pathlib import Path
+from typing import List, Optional, Tuple
+
+
+class SkillNameValidationError(ValueError):
+    """Raised when skill name doesn't conform to Agent Skills specification."""
+    pass
+
+
+class SkillNameValidationWarning(UserWarning):
+    """Warning for skill name validation issues."""
+    pass
+
+
+def validate_skill_name(name: str, skill_dir: Optional[Path] = None) -> Tuple[bool, List[str]]:
+    """
+    Validate skill name according to Agent Skills specification.
+    
+    Rules from Skills specification:
+    - Must be 1-64 characters
+    - May only contain lowercase alphanumeric characters and hyphens (a-z, 0-9, -)
+    - Must not start or end with hyphen (-)
+    - Must not contain consecutive hyphens (--)
+    - Must match the parent directory name (if skill_dir provided)
+    
+    Args:
+        name: The skill name to validate
+        skill_dir: Optional path to skill directory for directory name matching
+        
+    Returns:
+        Tuple of (is_valid, list_of_errors)
+    """
+    errors = []
+    
+    # Check length
+    if not name:
+        errors.append("Skill name cannot be empty")
+    elif len(name) > 64:
+        errors.append(f"Skill name exceeds 64 characters (got {len(name)})")
+    
+    # Check character set (lowercase alphanumeric and hyphens only)
+    if name and not re.match(r'^[a-z0-9-]+$', name):
+        invalid_chars = set(re.findall(r'[^a-z0-9-]', name))
+        if any(c.isupper() for c in name):
+            errors.append("Skill name must be lowercase (found uppercase characters)")
+        else:
+            errors.append(f"Skill name contains invalid characters: {invalid_chars}")
+    
+    # Check hyphen rules
+    if name:
+        if name.startswith('-'):
+            errors.append("Skill name must not start with a hyphen")
+        if name.endswith('-'):
+            errors.append("Skill name must not end with a hyphen")
+        if '--' in name:
+            errors.append("Skill name must not contain consecutive hyphens (--)")
+    
+    # Check directory name match
+    if skill_dir and name:
+        dir_name = skill_dir.name
+        if dir_name != name:
+            errors.append(f"Skill name '{name}' must match directory name '{dir_name}'")
+    
+    return len(errors) == 0, errors
+
+
+def validate_skill_name_strict(name: str, skill_dir: Optional[Path] = None) -> None:
+    """
+    Validate skill name and raise exception if invalid.
+    
+    Args:
+        name: The skill name to validate
+        skill_dir: Optional path to skill directory
+        
+    Raises:
+        SkillNameValidationError: If name is invalid
+    """
+    is_valid, errors = validate_skill_name(name, skill_dir)
+    if not is_valid:
+        raise SkillNameValidationError(
+            f"Invalid skill name '{name}': " + "; ".join(errors)
+        )
+
+
+def validate_skill_name_warn(name: str, skill_dir: Optional[Path] = None) -> bool:
+    """
+    Validate skill name and emit warnings if invalid.
+    
+    Args:
+        name: The skill name to validate
+        skill_dir: Optional path to skill directory
+        
+    Returns:
+        True if valid, False otherwise (with warnings emitted)
+    """
+    is_valid, errors = validate_skill_name(name, skill_dir)
+    if not is_valid:
+        for error in errors:
+            warnings.warn(
+                f"Skill name validation: {error}",
+                SkillNameValidationWarning,
+                stacklevel=3
+            )
+    return is_valid
+
+
+def validate_description(description: Optional[str]) -> Tuple[bool, List[str]]:
+    """
+    Validate skill description according to Agent Skills specification.
+    
+    Rules:
+    - Must be 1-1024 characters
+    - Should describe what the skill does and when to use it
+    
+    Args:
+        description: The skill description to validate
+        
+    Returns:
+        Tuple of (is_valid, list_of_errors)
+    """
+    errors = []
+    
+    if not description:
+        errors.append("Skill description is required")
+    elif len(description) > 1024:
+        errors.append(f"Skill description exceeds 1024 characters (got {len(description)})")
+    
+    return len(errors) == 0, errors

skilllite-0.1.0.dist-info/METADATA

@@ -0,0 +1,293 @@
+Metadata-Version: 2.4
+Name: skilllite
+Version: 0.1.0
+Summary: A lightweight Skills execution engine with LLM integration for LLM agents
+Author-email: SkillLite Team <skilllite@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/EXboys/skilllite
+Project-URL: Documentation, https://github.com/EXboys/skilllite#readme
+Project-URL: Repository, https://github.com/EXboys/skilllite
+Project-URL: Issues, https://github.com/EXboys/skilllite/issues
+Keywords: agent,skills,llm,claude,openai,sandbox,tools
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: openai
+Requires-Dist: openai>=1.0.0; extra == "openai"
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.18.0; extra == "anthropic"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.0.0; extra == "mcp"
+Provides-Extra: all
+Requires-Dist: openai>=1.0.0; extra == "all"
+Requires-Dist: anthropic>=0.18.0; extra == "all"
+Requires-Dist: mcp>=1.0.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# SkillLite Python SDK
+
+A Python SDK for the SkillLite execution engine, using **OpenAI-compatible API format** as the unified interface.
+
+## Supported Providers
+
+Works with any OpenAI-compatible LLM provider:
+- **OpenAI** (GPT-4, GPT-3.5, etc.)
+- **Azure OpenAI**
+- **Anthropic Claude** (via OpenAI-compatible endpoint or native)
+- **Google Gemini** (via OpenAI-compatible endpoint)
+- **Local models** (Ollama, vLLM, LMStudio, etc.)
+- **DeepSeek, Qwen, Moonshot, Zhipu**, and other providers
+
+## Installation
+
+```bash
+pip install skilllite
+
+# With OpenAI SDK (recommended, works with all compatible providers)
+pip install skilllite[openai]
+
+# With Anthropic SDK (for Claude's native API)
+pip install skilllite[anthropic]
+```
+
+## Prerequisites
+
+You need to have the `skillbox` binary installed:
+
+```bash
+# From the skillbox directory
+cargo install --path .
+```
+
+## Quick Start
+
+### Basic Usage (Universal - Works with Any Provider)
+
+```python
+from openai import OpenAI
+from skilllite import SkillManager
+
+# Works with ANY OpenAI-compatible provider
+# Just change base_url and api_key for different providers:
+
+# OpenAI
+client = OpenAI()
+
+# Ollama (local)
+# client = OpenAI(base_url="http://localhost:11434/v1", api_key="ollama")
+
+# DeepSeek
+# client = OpenAI(base_url="https://api.deepseek.com/v1", api_key="...")
+
+# Qwen (通义千问)
+# client = OpenAI(base_url="https://dashscope.aliyuncs.com/compatible-mode/v1", api_key="...")
+
+# Moonshot (月之暗面)
+# client = OpenAI(base_url="https://api.moonshot.cn/v1", api_key="...")
+
+# Initialize SkillManager
+manager = SkillManager(skills_dir="./my_skills")
+
+# Get tools (OpenAI-compatible format - works with all providers)
+tools = manager.get_tools()
+
+# Call any OpenAI-compatible API
+response = client.chat.completions.create(
+    model="gpt-4",  # or "llama2", "deepseek-chat", "qwen-turbo", etc.
+    tools=tools,
+    messages=[{"role": "user", "content": "Please help me with..."}]
+)
+
+# Handle tool calls (same code works for all providers!)
+if response.choices[0].message.tool_calls:
+    tool_results = manager.handle_tool_calls(response)
+    
+    # Continue conversation with results
+    messages = [
+        {"role": "user", "content": "Please help me with..."},
+        response.choices[0].message,
+        *[r.to_openai_format() for r in tool_results]
+    ]
+    
+    follow_up = client.chat.completions.create(
+        model="gpt-4",
+        tools=tools,
+        messages=messages
+    )
+```
+
+### Agentic Loop (Automatic Multi-turn Tool Execution)
+
+```python
+from openai import OpenAI
+from skilllite import SkillManager
+
+# Works with any provider
+client = OpenAI()  # or OpenAI(base_url="...", api_key="...")
+manager = SkillManager(skills_dir="./my_skills")
+
+# Create an agentic loop
+loop = manager.create_agentic_loop(
+    client=client,
+    model="gpt-4",
+    system_prompt="You are a helpful assistant with access to various skills.",
+    max_iterations=10,
+    temperature=0.7  # Additional kwargs passed to chat.completions.create()
+)
+
+# Run until completion - handles multiple tool calls automatically
+final_response = loop.run("Please analyze this data and generate a report.")
+print(final_response.choices[0].message.content)
+```
+
+### Claude Native API (Optional)
+
+If you prefer using Claude's native API directly:
+
+```python
+import anthropic
+from skilllite import SkillManager
+
+client = anthropic.Anthropic()
+manager = SkillManager(skills_dir="./my_skills")
+
+# Use Claude-specific methods
+tools = manager.get_tools_for_claude_native()
+response = client.messages.create(
+    model="claude-sonnet-4-20250514",
+    max_tokens=4096,
+    tools=tools,
+    messages=[{"role": "user", "content": "..."}]
+)
+
+if response.stop_reason == "tool_use":
+    results = manager.handle_tool_calls_claude_native(response)
+```
+
+## Creating Skills
+
+Skills are defined in directories with a `SKILL.md` file:
+
+```
+my_skills/
+├── web-search/
+│   ├── SKILL.md           # Metadata and docs (includes dependency declaration)
+│   └── scripts/
+│       └── main.py
+└── calculator/
+    ├── SKILL.md
+    └── scripts/
+        └── main.py
+```
+
+> **Note**: Python dependencies are declared in the `compatibility` field of `SKILL.md`, not in a separate `requirements.txt` file.
+
+### SKILL.md Format
+
+```markdown
+---
+name: web-search
+description: Search the web for information
+compatibility: Requires Python 3.x with requests library, network access
+license: MIT
+metadata:
+  author: example-org
+  version: "1.0"
+---
+
+# Web Search Skill
+
+This skill searches the web for information.
+
+## Input Parameters
+
+- `query`: The search query (required)
+```
+
+The `compatibility` field is used to:
+- Detect language (Python/Node/Bash)
+- Enable network access (keywords: network, internet, http, api, web)
+- Auto-install dependencies (known packages like requests, pandas, axios, etc.)
+
+### Skill Entry Point
+
+```python
+# main.py
+import json
+import sys
+
+def main():
+    # Read input from stdin
+    input_data = json.loads(sys.stdin.read())
+    
+    # Process the input
+    query = input_data.get("query", "")
+    
+    # Do something...
+    result = {"results": [f"Result for: {query}"]}
+    
+    # Output JSON to stdout
+    print(json.dumps(result))
+
+if __name__ == "__main__":
+    main()
+```
+
+## API Reference
+
+### SkillManager
+
+The main class for managing and executing skills.
+
+#### Constructor
+
+```python
+SkillManager(
+    skills_dir: Optional[str] = None,  # Directory containing skills
+    binary_path: Optional[str] = None,  # Path to skillbox binary
+    cache_dir: Optional[str] = None,    # Cache directory for venvs
+    allow_network: bool = False          # Default network access
+)
+```
+
+#### Methods
+
+- `scan_directory(directory)` - Scan for skills
+- `register_skill(skill_dir)` - Register a single skill
+- `get_skill(name)` - Get skill by name
+- `list_skills()` - List all skills
+- `get_tools_for_claude()` - Get Claude-format tools
+- `get_tools_for_openai()` - Get OpenAI-format tools
+- `execute(skill_name, input_data)` - Execute a skill
+- `handle_tool_calls(response, format)` - Handle LLM tool calls
+- `create_agentic_loop(...)` - Create an agentic loop
+
+### ToolFormat
+
+Enum for LLM provider formats:
+- `ToolFormat.CLAUDE`
+- `ToolFormat.OPENAI`
+
+## License
+
+MIT License

skilllite-0.1.0.dist-info/RECORD

@@ -0,0 +1,32 @@
+skilllite/__init__.py,sha256=Ws0SEhXeqPTme-ASatdgkIba49zhZItN1Xlh2TVdhDY,3984
+skilllite/analyzer.py,sha256=YG-ZJ6bO59pkP8LGECjcyCDPpH6wUYOm5QGx6et-ItA,14504
+skilllite/builtin_tools.py,sha256=MGIlMlYTfj590PCY4ngbQteDIryfH7sDoKQyrDTH6L8,8067
+skilllite/cli.py,sha256=Ns_wjCWz3Lh67P6QB7HYe2gM94FG8mEwKvPnQIx9uqI,6209
+skilllite/quick.py,sha256=TNqKaww92WHUMf9nkjMZkdVjzz222lOKyjCwNp90_9c,16132
+skilllite/validation.py,sha256=K3Hn6VKT7aybdKX8GXSRaxLbKmyVAnMYmP9cqh-D4s4,4308
+skilllite/core/__init__.py,sha256=nU9yWE_M7xuWaIa1Ks_0dPfilRpW9GhlKfTV6eEU7-U,2044
+skilllite/core/executor.py,sha256=eNPcVKxKcLUjHJ7K2hstKtxobZiDIvPjk2IhbZv3nxo,6517
+skilllite/core/handler.py,sha256=pbQo5Gv-YSecufqpVbC0y8KP7Ra4uxxYpOW1nBimn5g,10354
+skilllite/core/loops.py,sha256=2LEIyhYbHAR5YqvkyQeoRLYJPbKoEPaBK_wSMo47wKI,32210
+skilllite/core/manager.py,sha256=uYAO5JtHM4DQvPnybBChHe0hUdOse1yBiQyc7vZ4nB8,19798
+skilllite/core/metadata.py,sha256=mdZdK-qfK7wSaZrAAn2U25k0I63NrYuibtBHIrYR5RA,11221
+skilllite/core/prompt_builder.py,sha256=rsubLzien9lKjOqM6iTn5nourPnz1-QQGzljiO0Z_3I,12844
+skilllite/core/registry.py,sha256=AeljsV1uuYEJFGjpSwYxU6JGJ6EUuW8uNO3KirzHkuQ,6622
+skilllite/core/skill_info.py,sha256=4_jsArmn1e7jEUXDEkmDAzjSI_903sdpfNLHOp1t1-M,6079
+skilllite/core/tool_builder.py,sha256=k28ze50h7AjBiEfgKR6Y4DUFIGZJ1sCYbHEk_VkYl7w,12866
+skilllite/core/tools.py,sha256=3RiAnZ_7S7iE6ZHXTPNKmAYQFY8SBUEzcQJZA0tZmX8,8168
+skilllite/mcp/__init__.py,sha256=xrpoWy9zs8IJkW6fkkR4XjQrITo5PWvFW9NkmK8E2Fg,1028
+skilllite/mcp/server.py,sha256=vhM0Kgjul1DZ5XFFKjuWZ0iksFP4nWl9n_bpiaakpTM,27912
+skilllite/sandbox/__init__.py,sha256=6LPisVXB94SJ-C34nBAxd05NGEZR4PPxz2xaDpX4qEk,918
+skilllite/sandbox/base.py,sha256=-Ul2QufoQ3myJNzBOEdv30A2HVSR9Oe4zEqpe9oJGqY,2628
+skilllite/sandbox/config.py,sha256=eA3ceou6jF4S5kptv6cmIGKynQTaGDx3_vRrkJGQaAE,8207
+skilllite/sandbox/utils.py,sha256=o5AZVkhqIcZE9veUy7FTfN7uMHVWJJLYXs7gYIXsptg,2572
+skilllite/sandbox/skillbox/__init__.py,sha256=SFnNlLnnAc_NEEkqOkDbxYNfXROL7n1S09K_HFI_BOE,866
+skilllite/sandbox/skillbox/binary.py,sha256=TNKQamWucMw-J6L5BjAasNpYqhBcBpHwQPMqjUOkgp4,11838
+skilllite/sandbox/skillbox/executor.py,sha256=dXCR8JMwjD-x7-LfOCQbvgSq-29ZLIkXLp4oHed7b1Y,22872
+skilllite-0.1.0.dist-info/licenses/LICENSE,sha256=ESBZ3GI5LkrbA2s5jZUQDqdcQ8oRlmk04aIYh34cOsw,1071
+skilllite-0.1.0.dist-info/METADATA,sha256=-uHBXQuqfXHjGqsf5Qc5MELgUe9Lq_0UPUwpTFsyeTQ,8190
+skilllite-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+skilllite-0.1.0.dist-info/entry_points.txt,sha256=H-meSKN3XzctxMvY6fa-YjAWyzs9t_0IjujOfumn4Wk,84
+skilllite-0.1.0.dist-info/top_level.txt,sha256=aqo-9FEJuBbFT7WGE3aycTj27OxyQPCN6TuZtOcClAI,10
+skilllite-0.1.0.dist-info/RECORD,,

skilllite-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

skilllite-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+skilllite = skilllite.cli:main
+skilllite-mcp = skilllite.mcp:main

skilllite-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 SkillLite Team
+
+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.

skilllite-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+skilllite