skillware 0.2.8__tar.gz → 0.2.9__tar.gz

{skillware-0.2.8/skillware.egg-info → skillware-0.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skillware
-Version: 0.2.8
+Version: 0.2.9
 Summary: A framework for modular, self-contained AI skills.
 Author-email: ARPA Hellenic Logical Systems <skillware-os@arpacorp.net>
 License: MIT License
@@ -35,15 +35,29 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests
 Requires-Dist: pyyaml
-Requires-Dist: anthropic
-Requires-Dist: google-generativeai
-Requires-Dist: pymupdf
+Requires-Dist: python-dotenv
 Requires-Dist: beautifulsoup4
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-mock; extra == "dev"
 Requires-Dist: flake8; extra == "dev"
 Requires-Dist: black; extra == "dev"
+Provides-Extra: cli
+Requires-Dist: rich>=13.0; extra == "cli"
+Provides-Extra: gemini
+Requires-Dist: google-generativeai; extra == "gemini"
+Provides-Extra: claude
+Requires-Dist: anthropic; extra == "claude"
+Provides-Extra: openai
+Requires-Dist: openai; extra == "openai"
+Provides-Extra: office
+Requires-Dist: pymupdf; extra == "office"
+Provides-Extra: all
+Requires-Dist: rich>=13.0; extra == "all"
+Requires-Dist: google-generativeai; extra == "all"
+Requires-Dist: anthropic; extra == "all"
+Requires-Dist: openai; extra == "all"
+Requires-Dist: pymupdf; extra == "all"
 Dynamic: license-file
 
 <div align="center">
@@ -106,6 +120,7 @@ Skillware/
 │           ├── instructions.md # Cognitive map for the LLM
 │           └── test_skill.py   # Unit tests & schema validation
 ├── skillware/                  # Core Framework Package
+│   ├── cli.py                  # Command-line interface
 │   └── core/
 │       ├── base_skill.py       # Abstract Base Class for skills
 │       ├── env.py              # Environment Management
@@ -135,7 +150,16 @@ pip install -e .
 
 > **Note**: Individual skills may have their own dependencies. The `SkillLoader` validates `manifest.yaml` and warns of missing packages (e.g., `requests`, `pandas`) upon loading a skill.
 
-### 2. Configuration
+### 2. Verify your installation
+
+```bash
+pip install "skillware[cli]"
+skillware list
+```
+
+This prints a table of all locally available skills and confirms the install and path resolution are working.
+
+### 3. Configuration
 
 Create a `.env` file with your API keys (e.g., Google Gemini API Key):
 
@@ -143,7 +167,7 @@ Create a `.env` file with your API keys (e.g., Google Gemini API Key):
 GOOGLE_API_KEY="your_key"
 ```
 
-### 3. Usage Example (Gemini)
+### 4. Usage Example (Gemini)
 
 ```python
 import google.generativeai as genai
@@ -184,6 +208,7 @@ print(response.text)
 *   **[Usage Guide: Ollama](docs/usage/ollama.md)**: Native integration for local models via Ollama.
 *   **[API Keys for Skills](docs/usage/api_keys.md)**: Environment variables, cloud/CI setup, and security for skills that call external APIs.
 *   **[Skill Library](docs/skills/README.md)**: Available capabilities.
+*   **[CLI Reference](docs/usage/cli.md)**: Discover and inspect locally installed skills from the terminal.
 
 ## Contributing
 

{skillware-0.2.8 → skillware-0.2.9}/README.md

@@ -58,6 +58,7 @@ Skillware/
 │           ├── instructions.md # Cognitive map for the LLM
 │           └── test_skill.py   # Unit tests & schema validation
 ├── skillware/                  # Core Framework Package
+│   ├── cli.py                  # Command-line interface
 │   └── core/
 │       ├── base_skill.py       # Abstract Base Class for skills
 │       ├── env.py              # Environment Management
@@ -87,7 +88,16 @@ pip install -e .
 
 > **Note**: Individual skills may have their own dependencies. The `SkillLoader` validates `manifest.yaml` and warns of missing packages (e.g., `requests`, `pandas`) upon loading a skill.
 
-### 2. Configuration
+### 2. Verify your installation
+
+```bash
+pip install "skillware[cli]"
+skillware list
+```
+
+This prints a table of all locally available skills and confirms the install and path resolution are working.
+
+### 3. Configuration
 
 Create a `.env` file with your API keys (e.g., Google Gemini API Key):
 
@@ -95,7 +105,7 @@ Create a `.env` file with your API keys (e.g., Google Gemini API Key):
 GOOGLE_API_KEY="your_key"
 ```
 
-### 3. Usage Example (Gemini)
+### 4. Usage Example (Gemini)
 
 ```python
 import google.generativeai as genai
@@ -136,6 +146,7 @@ print(response.text)
 *   **[Usage Guide: Ollama](docs/usage/ollama.md)**: Native integration for local models via Ollama.
 *   **[API Keys for Skills](docs/usage/api_keys.md)**: Environment variables, cloud/CI setup, and security for skills that call external APIs.
 *   **[Skill Library](docs/skills/README.md)**: Available capabilities.
+*   **[CLI Reference](docs/usage/cli.md)**: Discover and inspect locally installed skills from the terminal.
 
 ## Contributing
 

{skillware-0.2.8 → skillware-0.2.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "skillware"
-version = "0.2.8"
+version = "0.2.9"
 description = "A framework for modular, self-contained AI skills."
 readme = "README.md"
 authors = [
@@ -20,13 +20,14 @@ classifiers = [
 dependencies = [
     "requests",
     "pyyaml",
-    "anthropic",
-    "google-generativeai",
-    "pymupdf",
+    "python-dotenv",
     "beautifulsoup4",
 ]
 requires-python = ">=3.10"
 
+[project.scripts]
+skillware = "skillware.cli:main"
+
 [project.optional-dependencies]
 dev = [
     "pytest",
@@ -34,6 +35,28 @@ dev = [
     "flake8",
     "black",
 ]
+cli = [
+    "rich>=13.0",
+]
+gemini = [
+    "google-generativeai",
+]
+claude = [
+    "anthropic",
+]
+openai = [
+    "openai",
+]
+office = [
+    "pymupdf",
+]
+all = [
+    "rich>=13.0",
+    "google-generativeai",
+    "anthropic",
+    "openai",
+    "pymupdf",
+]
 
 [tool.setuptools]
 include-package-data = true

skillware-0.2.9/skillware/cli.py

@@ -0,0 +1,162 @@
+import argparse
+import yaml
+from pathlib import Path
+from typing import List, Dict, Any, Optional
+
+from skillware.core.loader import SkillLoader
+
+
+def _get_skill_roots(skills_root_override: Optional[Path] = None) -> List[Path]:
+    """Return the list of roots to search for skills, mirrors SkillLoader resolution order."""
+    if skills_root_override is not None:
+        if skills_root_override.exists():
+            return [skills_root_override]
+        return []
+
+    roots = []
+    seen = set()
+
+    for root in (
+        SkillLoader._env_skill_roots()
+        + SkillLoader._cwd_skill_roots()
+        + [SkillLoader._bundled_skills_root()]
+    ):
+        resolved = root.resolve()
+        if resolved not in seen and resolved.exists():
+            seen.add(resolved)
+            roots.append(resolved)
+
+    return roots
+
+
+def _discover_skills(
+    skills_root_override: Optional[Path] = None,
+) -> List[Dict[str, Any]]:
+    """Walk all skill roots and return a list of dicts with each skill's metadata."""
+    roots = _get_skill_roots(skills_root_override)
+
+    skills = []
+    seen_ids = set()
+
+    for root in roots:
+        for manifest_path in root.glob("*/*/manifest.yaml"):
+
+            if not SkillLoader._is_skill_dir(manifest_path.parent):
+                continue
+
+            with open(manifest_path, encoding="utf-8") as f:
+                data = yaml.safe_load(f) or {}
+
+            skill_id = f"{manifest_path.parent.parent.name}/{manifest_path.parent.name}"
+
+            # skip duplicates found in multiple roots
+            if skill_id in seen_ids:
+                continue
+            seen_ids.add(skill_id)
+
+            issuer = data.get("issuer") or {}
+
+            skills.append(
+                {
+                    "id": skill_id,
+                    "category": manifest_path.parent.parent.name,
+                    "name": manifest_path.parent.name,
+                    "version": data.get("version", "?").strip(),
+                    "description": data.get("description", "").strip(),
+                    "requirements": ", ".join(data.get("requirements") or []).strip(),
+                    "issuer": issuer.get("github") or issuer.get("name") or "",
+                }
+            )
+
+    return skills
+
+
+def cmd_list(
+    skills_root_override: Optional[Path] = None,
+    category_filter: Optional[str] = None,
+    issuer_filter: Optional[str] = None,
+    console=None,
+) -> None:
+    """Print a formatted table of all available skills."""
+    try:
+        from rich.table import Table
+        from rich.console import Console
+    except ImportError:
+        raise SystemExit(
+            "rich is required for the CLI. Install it with: pip install 'skillware[cli]'"
+        )
+
+    if console is None:
+        console = Console()
+
+    skills = _discover_skills(skills_root_override)
+
+    if category_filter:
+        skills = [s for s in skills if s["category"] == category_filter]
+
+    if issuer_filter:
+        skills = [s for s in skills if s["issuer"] == issuer_filter]
+
+    if not skills:
+        console.print("No skills found.")
+        return
+
+    table = Table()
+
+    table.add_column("ID")
+    table.add_column("VERSION")
+    table.add_column("CATEGORY")
+    table.add_column("ISSUER")
+    table.add_column("DESCRIPTION")
+    table.add_column("REQUIREMENTS")
+
+    for skill in skills:
+        table.add_row(
+            skill["id"],
+            skill["version"],
+            skill["category"],
+            skill["issuer"],
+            skill["description"],
+            skill["requirements"],
+        )
+
+    console.print(table)
+
+
+def main() -> None:
+    """CLI entry point."""
+    parser = argparse.ArgumentParser(prog="skillware")
+    subparsers = parser.add_subparsers(dest="command")
+
+    list_parser = subparsers.add_parser("list", help="List all available skills.")
+    list_parser.add_argument(
+        "--skills-root",
+        type=Path,
+        default=None,
+        help="Override the skills directory path.",
+    )
+    list_parser.add_argument(
+        "--category",
+        default=None,
+        help="Filter skills by category.",
+    )
+    list_parser.add_argument(
+        "--issuer",
+        default=None,
+        help="Filter skills by issuer GitHub handle or name.",
+    )
+
+    args = parser.parse_args()
+
+    if args.command == "list":
+        cmd_list(
+            skills_root_override=args.skills_root,
+            category_filter=args.category,
+            issuer_filter=args.issuer,
+        )
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    main()

{skillware-0.2.8 → skillware-0.2.9/skillware.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skillware
-Version: 0.2.8
+Version: 0.2.9
 Summary: A framework for modular, self-contained AI skills.
 Author-email: ARPA Hellenic Logical Systems <skillware-os@arpacorp.net>
 License: MIT License
@@ -35,15 +35,29 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: requests
 Requires-Dist: pyyaml
-Requires-Dist: anthropic
-Requires-Dist: google-generativeai
-Requires-Dist: pymupdf
+Requires-Dist: python-dotenv
 Requires-Dist: beautifulsoup4
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-mock; extra == "dev"
 Requires-Dist: flake8; extra == "dev"
 Requires-Dist: black; extra == "dev"
+Provides-Extra: cli
+Requires-Dist: rich>=13.0; extra == "cli"
+Provides-Extra: gemini
+Requires-Dist: google-generativeai; extra == "gemini"
+Provides-Extra: claude
+Requires-Dist: anthropic; extra == "claude"
+Provides-Extra: openai
+Requires-Dist: openai; extra == "openai"
+Provides-Extra: office
+Requires-Dist: pymupdf; extra == "office"
+Provides-Extra: all
+Requires-Dist: rich>=13.0; extra == "all"
+Requires-Dist: google-generativeai; extra == "all"
+Requires-Dist: anthropic; extra == "all"
+Requires-Dist: openai; extra == "all"
+Requires-Dist: pymupdf; extra == "all"
 Dynamic: license-file
 
 <div align="center">
@@ -106,6 +120,7 @@ Skillware/
 │           ├── instructions.md # Cognitive map for the LLM
 │           └── test_skill.py   # Unit tests & schema validation
 ├── skillware/                  # Core Framework Package
+│   ├── cli.py                  # Command-line interface
 │   └── core/
 │       ├── base_skill.py       # Abstract Base Class for skills
 │       ├── env.py              # Environment Management
@@ -135,7 +150,16 @@ pip install -e .
 
 > **Note**: Individual skills may have their own dependencies. The `SkillLoader` validates `manifest.yaml` and warns of missing packages (e.g., `requests`, `pandas`) upon loading a skill.
 
-### 2. Configuration
+### 2. Verify your installation
+
+```bash
+pip install "skillware[cli]"
+skillware list
+```
+
+This prints a table of all locally available skills and confirms the install and path resolution are working.
+
+### 3. Configuration
 
 Create a `.env` file with your API keys (e.g., Google Gemini API Key):
 
@@ -143,7 +167,7 @@ Create a `.env` file with your API keys (e.g., Google Gemini API Key):
 GOOGLE_API_KEY="your_key"
 ```
 
-### 3. Usage Example (Gemini)
+### 4. Usage Example (Gemini)
 
 ```python
 import google.generativeai as genai
@@ -184,6 +208,7 @@ print(response.text)
 *   **[Usage Guide: Ollama](docs/usage/ollama.md)**: Native integration for local models via Ollama.
 *   **[API Keys for Skills](docs/usage/api_keys.md)**: Environment variables, cloud/CI setup, and security for skills that call external APIs.
 *   **[Skill Library](docs/skills/README.md)**: Available capabilities.
+*   **[CLI Reference](docs/usage/cli.md)**: Discover and inspect locally installed skills from the terminal.
 
 ## Contributing
 

{skillware-0.2.8 → skillware-0.2.9}/skillware.egg-info/SOURCES.txt

@@ -61,15 +61,18 @@ skills/optimization/prompt_rewriter/instructions.md
 skills/optimization/prompt_rewriter/manifest.yaml
 skills/optimization/prompt_rewriter/skill.py
 skillware/__init__.py
+skillware/cli.py
 skillware.egg-info/PKG-INFO
 skillware.egg-info/SOURCES.txt
 skillware.egg-info/dependency_links.txt
+skillware.egg-info/entry_points.txt
 skillware.egg-info/requires.txt
 skillware.egg-info/top_level.txt
 skillware/core/__init__.py
 skillware/core/base_skill.py
 skillware/core/env.py
 skillware/core/loader.py
+tests/test_cli.py
 tests/test_loader.py
 tests/test_mica_module.py
 tests/test_skill_issuer.py

skillware-0.2.9/skillware.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+skillware = skillware.cli:main

skillware-0.2.9/skillware.egg-info/requires.txt

@@ -0,0 +1,32 @@
+requests
+pyyaml
+python-dotenv
+beautifulsoup4
+
+[all]
+rich>=13.0
+google-generativeai
+anthropic
+openai
+pymupdf
+
+[claude]
+anthropic
+
+[cli]
+rich>=13.0
+
+[dev]
+pytest
+pytest-mock
+flake8
+black
+
+[gemini]
+google-generativeai
+
+[office]
+pymupdf
+
+[openai]
+openai

skillware-0.2.9/tests/test_cli.py

@@ -0,0 +1,140 @@
+from skillware.cli import _discover_skills, cmd_list
+
+
+def test_discover_skills_returns_skills(tmp_path):
+    # Create a fake skill directory structure
+    skill_dir = tmp_path / "office" / "pdf_form_filler"
+    skill_dir.mkdir(parents=True)
+    (skill_dir / "skill.py").touch()
+
+    manifest = skill_dir / "manifest.yaml"
+    manifest.write_text(
+        "name: pdf_form_filler\n"
+        "version: 0.1.0\n"
+        "description: Fills PDF forms.\n"
+        "requirements:\n"
+        "  - pymupdf\n"
+    )
+
+    skills = _discover_skills(tmp_path)
+
+    assert len(skills) == 1
+    assert skills[0]["id"] == "office/pdf_form_filler"
+    assert skills[0]["version"] == "0.1.0"
+
+
+def test_discover_skills_empty_directory(tmp_path):
+    # No skills created, directory is empty
+    skills = _discover_skills(tmp_path)
+
+    assert skills == []
+
+
+def test_discover_skills_nonexistent_override_falls_back(tmp_path, monkeypatch):
+    # An override path that does not exist should be ignored
+    # and fall back to other roots without crashing
+    monkeypatch.chdir(tmp_path)
+    fake_path = tmp_path / "nonexistent"
+
+    # Should not raise, just return empty list since no roots have skills
+    skills = _discover_skills(fake_path)
+    assert skills == []
+
+
+def test_discover_skills_missing_optional_fields(tmp_path):
+    # Manifest with only required fields, no version, description or requirements
+    skill_dir = tmp_path / "office" / "minimal_skill"
+    skill_dir.mkdir(parents=True)
+    (skill_dir / "skill.py").touch()
+
+    manifest = skill_dir / "manifest.yaml"
+    manifest.write_text("name: minimal_skill\n")
+
+    skills = _discover_skills(tmp_path)
+
+    assert len(skills) == 1
+    assert skills[0]["version"] == "?"
+    assert skills[0]["description"] == ""
+    assert skills[0]["requirements"] == ""
+
+
+def test_discover_skills_ignores_deeply_nested_manifest(tmp_path):
+    # manifest.yaml three levels deep should not be picked up
+    skill_dir = tmp_path / "office" / "pdf_form_filler" / "extra"
+    skill_dir.mkdir(parents=True)
+
+    manifest = skill_dir / "manifest.yaml"
+    manifest.write_text("name: should_not_appear\nversion: 0.1.0\n")
+
+    skills = _discover_skills(tmp_path)
+
+    assert skills == []
+
+
+def test_discover_skills_includes_issuer(tmp_path):
+    # Manifest with issuer github handle
+    skill_dir = tmp_path / "office" / "pdf_form_filler"
+    skill_dir.mkdir(parents=True)
+    (skill_dir / "skill.py").touch()
+
+    manifest = skill_dir / "manifest.yaml"
+    manifest.write_text(
+        "name: pdf_form_filler\n"
+        "version: 0.1.0\n"
+        "description: Fills PDF forms.\n"
+        "issuer:\n"
+        "  name: Ross Peili\n"
+        "  github: rosspeili\n"
+    )
+
+    skills = _discover_skills(tmp_path)
+
+    assert skills[0]["issuer"] == "rosspeili"
+
+
+def test_discover_skills_issuer_falls_back_to_name(tmp_path):
+    # Manifest with issuer name but no github handle
+    skill_dir = tmp_path / "office" / "pdf_form_filler"
+    skill_dir.mkdir(parents=True)
+    (skill_dir / "skill.py").touch()
+
+    manifest = skill_dir / "manifest.yaml"
+    manifest.write_text(
+        "name: pdf_form_filler\n"
+        "version: 0.1.0\n"
+        "description: Fills PDF forms.\n"
+        "issuer:\n"
+        "  name: Ross Peili\n"
+    )
+
+    skills = _discover_skills(tmp_path)
+
+    assert skills[0]["issuer"] == "Ross Peili"
+
+
+def test_cmd_list_filter_by_category(tmp_path):
+    # Only skills matching the category should appear
+    import io
+    from rich.console import Console
+
+    for category, name in [
+        ("office", "pdf_form_filler"),
+        ("finance", "wallet_screening"),
+    ]:
+        skill_dir = tmp_path / category / name
+        skill_dir.mkdir(parents=True)
+        (skill_dir / "skill.py").touch()
+        (skill_dir / "manifest.yaml").write_text(
+            f"name: {name}\nversion: 0.1.0\ndescription: Test.\n"
+        )
+
+    buf = io.StringIO()
+    cmd_list(
+        skills_root_override=tmp_path,
+        category_filter="office",
+        console=Console(file=buf, force_terminal=False),
+    )
+
+    output = buf.getvalue()
+    assert "office" in output
+    assert "finance" not in output

skillware-0.2.8/skillware.egg-info/requires.txt

@@ -1,12 +0,0 @@
-requests
-pyyaml
-anthropic
-google-generativeai
-pymupdf
-beautifulsoup4
-
-[dev]
-pytest
-pytest-mock
-flake8
-black