agent-skill-manager 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

{agent_skill_manager-0.1.0.dist-info → agent_skill_manager-0.1.1.dist-info}/METADATA

@@ -1,8 +1,21 @@
 Metadata-Version: 2.4
 Name: agent-skill-manager
-Version: 0.1.0
+Version: 0.1.1
 Summary: CLI tool for managing AI agent skills across multiple platforms
+Project-URL: Homepage, https://github.com/ackness/skill-manager
+Project-URL: Repository, https://github.com/ackness/skill-manager
+Project-URL: Issues, https://github.com/ackness/skill-manager/issues
+Project-URL: Documentation, https://github.com/ackness/skill-manager#readme
 Author-email: ackness <ackness8@gmail.com>
+License: MIT
+Keywords: agents,ai,claude,cli,cursor,skills,windsurf
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
 Requires-Python: >=3.13
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: inquirerpy>=0.3.4
@@ -46,14 +59,32 @@ A comprehensive CLI tool for managing AI agent skills across multiple platforms.
 
 ## Installation
 
-### From PyPI
+### Quick Run with uvx (No Installation Required)
+
+Run directly without installing (recommended for trying it out):
 
 ```bash
-# Using pip
-pip install agent-skill-manager
+# Show help (default command)
+uvx agent-skill-manager
+
+# Use sm command for specific operations
+uvx --from agent-skill-manager sm install
+uvx --from agent-skill-manager sm list
+uvx --from agent-skill-manager sm update --all
+
+# Or create an alias for convenience
+alias sm="uvx --from agent-skill-manager sm"
+sm install  # Now you can use it like the installed version
+```
 
+### Permanent Installation
+
+```bash
 # Using uv (recommended)
-uv pip install agent-skill-manager
+uv tool install agent-skill-manager
+
+# Using pip
+pip install agent-skill-manager
 
 # Using pipx (isolated installation)
 pipx install agent-skill-manager
@@ -68,23 +99,28 @@ uv sync
 uv pip install -e .
 ```
 
-## Quick Start
-
-```bash
-# Install a skill from GitHub
-sm install
-
-# List installed skills
-sm list
+## Usage Methods Comparison
 
-# Update all skills
-sm update --all
+| Method | Command | Use Case |
+|--------|---------|----------|
+| **uvx (no install)** | `uvx --from agent-skill-manager sm install` | One-time use, testing, CI/CD |
+| **uv tool install** | `uv tool install agent-skill-manager` then `sm install` | Regular use, isolated |
+| **pip install** | `pip install agent-skill-manager` then `sm install` | Traditional installation |
+| **From source** | `git clone ...` then `uv pip install -e .` | Development |
 
-# Deploy local skills to agents
-sm deploy
+## Quick Start
 
-# Uninstall a skill (safe delete)
-sm uninstall
+```bash
+# Run without installing (using uvx)
+uvx --from agent-skill-manager sm install
+uvx --from agent-skill-manager sm list
+
+# Or after installation, use sm command directly:
+sm install          # Install a skill from GitHub
+sm list            # List installed skills
+sm update --all    # Update all skills
+sm deploy          # Deploy local skills to agents
+sm uninstall       # Uninstall a skill (safe delete)
 ```
 
 ## Commands

agent_skill_manager-0.1.1.dist-info/RECORD

@@ -0,0 +1,12 @@
+skill_manager/__init__.py,sha256=0XIUCOGXT7Emm8ZLJ9YbNM-4Dv2v-m4Fkavq5onzwrY,1717
+skill_manager/agents.py,sha256=1sqdXQwoZCXhedyfo608crZp3rjPX6-LpFU9WsK45sU,3590
+skill_manager/cli.py,sha256=RMqOTzJlB1cHeA4DrPEdFSQyRKjNX8CA-HpuxDq1CRE,36295
+skill_manager/deployment.py,sha256=nq57YxdLNm_gEvxY28kLTxltEiq8Fyx-OltC0x7zpww,7697
+skill_manager/github.py,sha256=WIju94QHVcJnCprwHujticgkeWs0Z07AXOJ6a39wKTg,4841
+skill_manager/metadata.py,sha256=IEb1R8tDuJ5BfXTIsQ8ZiJRlbQ5aXScQPTXFego1J0k,3458
+skill_manager/removal.py,sha256=3yAn0Fd92_X40Z_SmxELHKKrWxew0vUGS8WO6Uq3730,8040
+skill_manager/validation.py,sha256=fRUJDs4TiuKlH3doey31SPJfe671JJQcBFSAhJwoSIE,1970
+agent_skill_manager-0.1.1.dist-info/METADATA,sha256=qfrREjAu7323WrdIkrsP0OQIUw8nkaGMDuS8yszu3I0,7318
+agent_skill_manager-0.1.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+agent_skill_manager-0.1.1.dist-info/entry_points.txt,sha256=ac3L07OC98p1llk259d9PUhDp-cl3ifV2nmYHGb3WO8,85
+agent_skill_manager-0.1.1.dist-info/RECORD,,

skill_manager/__init__.py

@@ -0,0 +1,79 @@
+"""
+Skill Manager - Tool for managing AI agent skills.
+
+This package provides functionality to download, deploy, and manage
+skills across different AI agent platforms.
+"""
+
+__version__ = "0.1.0"
+
+from .agents import AGENTS, detect_existing_agents, get_agent_name, get_agent_path
+from .deployment import (
+    deploy_multiple_skills,
+    deploy_skill,
+    deploy_skill_to_agents,
+    update_all_skills,
+    update_skill,
+)
+from .github import (
+    download_skill_from_github,
+    parse_github_url,
+)
+from .metadata import (
+    has_github_source,
+    list_updatable_skills,
+    read_skill_metadata,
+    save_skill_metadata,
+    update_skill_metadata,
+)
+from .removal import (
+    clean_trash,
+    hard_delete_skill,
+    list_installed_skills,
+    list_trashed_skills,
+    restore_skill,
+    soft_delete_skill,
+)
+from .validation import (
+    get_project_root,
+    get_skill_name,
+    scan_available_skills,
+    validate_skill,
+)
+
+__all__ = [
+    # Version
+    "__version__",
+    # Agents
+    "AGENTS",
+    "detect_existing_agents",
+    "get_agent_name",
+    "get_agent_path",
+    # Deployment
+    "deploy_skill",
+    "deploy_skill_to_agents",
+    "deploy_multiple_skills",
+    "update_skill",
+    "update_all_skills",
+    # GitHub
+    "download_skill_from_github",
+    "parse_github_url",
+    # Metadata
+    "save_skill_metadata",
+    "read_skill_metadata",
+    "update_skill_metadata",
+    "list_updatable_skills",
+    "has_github_source",
+    # Removal
+    "soft_delete_skill",
+    "hard_delete_skill",
+    "restore_skill",
+    "list_installed_skills",
+    "list_trashed_skills",
+    "clean_trash",
+    # Validation
+    "validate_skill",
+    "get_skill_name",
+    "get_project_root",
+    "scan_available_skills",
+]

skill_manager/agents.py

@@ -0,0 +1,137 @@
+#!/usr/bin/env python3
+"""
+Agent configuration and detection module.
+Manages different AI agent skill directory configurations.
+"""
+
+from pathlib import Path
+
+# Agent configuration mapping
+# Each agent has a name, project-level path, and global path
+AGENTS = {
+    "opencode": {
+        "name": "OpenCode",
+        "project": ".opencode/skills/",
+        "global": "~/.config/opencode/skills/",
+    },
+    "claude-code": {
+        "name": "Claude Code",
+        "project": ".claude/skills/",
+        "global": "~/.claude/skills/",
+    },
+    "codex": {
+        "name": "Codex",
+        "project": ".codex/skills/",
+        "global": "~/.codex/skills/",
+    },
+    "cursor": {
+        "name": "Cursor",
+        "project": ".cursor/skills/",
+        "global": "~/.cursor/skills/",
+    },
+    "amp": {
+        "name": "Amp",
+        "project": ".agents/skills/",
+        "global": "~/.config/agents/skills/",
+    },
+    "kilo": {
+        "name": "Kilo Code",
+        "project": ".kilocode/skills/",
+        "global": "~/.kilocode/skills/",
+    },
+    "roo": {
+        "name": "Roo Code",
+        "project": ".roo/skills/",
+        "global": "~/.roo/skills/",
+    },
+    "goose": {
+        "name": "Goose",
+        "project": ".goose/skills/",
+        "global": "~/.config/goose/skills/",
+    },
+    "gemini-cli": {
+        "name": "Gemini CLI",
+        "project": ".gemini/skills/",
+        "global": "~/.gemini/skills/",
+    },
+    "antigravity": {
+        "name": "Antigravity",
+        "project": ".agent/skills/",
+        "global": "~/.gemini/antigravity/skills/",
+    },
+    "github-copilot": {
+        "name": "GitHub Copilot",
+        "project": ".github/skills/",
+        "global": "~/.copilot/skills/",
+    },
+    "clawdbot": {
+        "name": "Clawdbot",
+        "project": "skills/",
+        "global": "~/.clawdbot/skills/",
+    },
+    "droid": {
+        "name": "Droid",
+        "project": ".factory/skills/",
+        "global": "~/.factory/skills/",
+    },
+    "windsurf": {
+        "name": "Windsurf",
+        "project": ".windsurf/skills/",
+        "global": "~/.codeium/windsurf/skills/",
+    },
+}
+
+
+def detect_existing_agents() -> dict[str, Path]:
+    """
+    Detect which agents are installed on the system.
+
+    Returns:
+        Dictionary mapping agent IDs to their global paths for installed agents.
+    """
+    existing = {}
+    for agent_id, info in AGENTS.items():
+        global_path = Path(info["global"]).expanduser()
+        if global_path.exists():
+            existing[agent_id] = global_path
+    return existing
+
+
+def get_agent_path(agent_id: str, deployment_type: str = "global", project_root: Path | None = None) -> Path:
+    """
+    Get the target path for an agent.
+
+    Args:
+        agent_id: The agent identifier
+        deployment_type: Either "global" or "project"
+        project_root: The project root directory (required for project deployment)
+
+    Returns:
+        The target path for the agent
+    """
+    if agent_id not in AGENTS:
+        raise ValueError(f"Unknown agent: {agent_id}")
+
+    info = AGENTS[agent_id]
+
+    if deployment_type == "global":
+        return Path(info["global"]).expanduser()
+    else:
+        if project_root is None:
+            project_root = Path.cwd()
+        return project_root / info["project"]
+
+
+def get_agent_name(agent_id: str) -> str:
+    """
+    Get the display name for an agent.
+
+    Args:
+        agent_id: The agent identifier
+
+    Returns:
+        The agent's display name
+    """
+    if agent_id not in AGENTS:
+        raise ValueError(f"Unknown agent: {agent_id}")
+    return AGENTS[agent_id]["name"]