agent-skill-manager 0.1.3__py3-none-any.whl → 0.2.1__py3-none-any.whl

{agent_skill_manager-0.1.3.dist-info → agent_skill_manager-0.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-skill-manager
-Version: 0.1.3
+Version: 0.2.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
@@ -36,28 +36,69 @@ A comprehensive CLI tool for managing AI agent skills across multiple platforms.
 ## Features
 
 - 📥 **Download** skills from GitHub with metadata tracking
-- 🚀 **Deploy** skills to multiple AI agents (global or project-level)
-- 🔄 **Update** skills automatically from GitHub sources
+- � **Discover** all skills in a repository automatically
+- � **Deploy** skills to multiple AI agents (global or project-level)
+- � **Symlink** support - save disk space with symbolic links
+- � **Update** skills automatically from GitHub sources
 - 🗑️ **Uninstall** with safe deletion (move to trash) or hard delete
 - ♻️ **Restore** deleted skills from trash
 - 📋 **List** all installed skills with version information
+- ⚡ **CLI-first** - full command-line parameter support for automation
 
 ## Supported AI Agents
 
-- Claude Code
-- Cursor
-- Windsurf
-- OpenCode
-- GitHub Copilot
-- Goose
-- Gemini CLI
-- Roo Code
-- Kilo Code
-- Amp
-- Codex
-- Antigravity
-- Clawdbot
-- Droid
+<!-- supported-agents:start -->
+| Agent | `--agent` | Project Path | Global Path |
+|-------|-----------|--------------|-------------|
+| Amp, Kimi Code CLI | `amp`, `kimi-cli` | `.agents/skills/` | `~/.config/agents/skills/` |
+| Antigravity | `antigravity` | `.agent/skills/` | `~/.gemini/antigravity/skills/` |
+| Augment | `augment` | `.augment/rules/` | `~/.augment/rules/` |
+| Claude Code | `claude-code` | `.claude/skills/` | `~/.claude/skills/` |
+| OpenClaw | `openclaw` | `skills/` | `~/.moltbot/skills/` |
+| Cline | `cline` | `.cline/skills/` | `~/.cline/skills/` |
+| CodeBuddy | `codebuddy` | `.codebuddy/skills/` | `~/.codebuddy/skills/` |
+| Codex | `codex` | `.agents/skills/` | `~/.codex/skills/` |
+| Command Code | `command-code` | `.commandcode/skills/` | `~/.commandcode/skills/` |
+| Continue | `continue` | `.continue/skills/` | `~/.continue/skills/` |
+| Crush | `crush` | `.crush/skills/` | `~/.config/crush/skills/` |
+| Cursor | `cursor` | `.cursor/skills/` | `~/.cursor/skills/` |
+| Droid | `droid` | `.factory/skills/` | `~/.factory/skills/` |
+| Gemini CLI | `gemini-cli` | `.agents/skills/` | `~/.gemini/skills/` |
+| GitHub Copilot | `github-copilot` | `.agents/skills/` | `~/.copilot/skills/` |
+| Goose | `goose` | `.goose/skills/` | `~/.config/goose/skills/` |
+| Junie | `junie` | `.junie/skills/` | `~/.junie/skills/` |
+| iFlow CLI | `iflow-cli` | `.iflow/skills/` | `~/.iflow/skills/` |
+| Kilo Code | `kilo` | `.kilocode/skills/` | `~/.kilocode/skills/` |
+| Kiro CLI | `kiro-cli` | `.kiro/skills/` | `~/.kiro/skills/` |
+| Kode | `kode` | `.kode/skills/` | `~/.kode/skills/` |
+| MCPJam | `mcpjam` | `.mcpjam/skills/` | `~/.mcpjam/skills/` |
+| Mistral Vibe | `mistral-vibe` | `.vibe/skills/` | `~/.vibe/skills/` |
+| Mux | `mux` | `.mux/skills/` | `~/.mux/skills/` |
+| OpenCode | `opencode` | `.agents/skills/` | `~/.config/opencode/skills/` |
+| OpenHands | `openhands` | `.openhands/skills/` | `~/.openhands/skills/` |
+| Pi | `pi` | `.pi/skills/` | `~/.pi/agent/skills/` |
+| Qoder | `qoder` | `.qoder/skills/` | `~/.qoder/skills/` |
+| Qwen Code | `qwen-code` | `.qwen/skills/` | `~/.qwen/skills/` |
+| Replit | `replit` | `.agents/skills/` | N/A (project-only) |
+| Roo Code | `roo` | `.roo/skills/` | `~/.roo/skills/` |
+| Trae | `trae` | `.trae/skills/` | `~/.trae/skills/` |
+| Trae CN | `trae-cn` | `.trae/skills/` | `~/.trae-cn/skills/` |
+| Windsurf | `windsurf` | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
+| Zencoder | `zencoder` | `.zencoder/skills/` | `~/.zencoder/skills/` |
+| Neovate | `neovate` | `.neovate/skills/` | `~/.neovate/skills/` |
+| Pochi | `pochi` | `.pochi/skills/` | `~/.pochi/skills/` |
+| AdaL | `adal` | `.adal/skills/` | `~/.adal/skills/` |
+<!-- supported-agents:end -->
+
+> [!NOTE]
+> **Kiro CLI users:** After installing skills, manually add them to your custom agent's `resources` in
+> `.kiro/agents/<agent>.json`:
+>
+> ```json
+> {
+>   "resources": ["skill://.kiro/skills/**/SKILL.md"]
+> }
+> ```
 
 ## Installation
 
@@ -128,34 +169,78 @@ 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)
+sm install          # Install a skill from GitHub (interactive)
+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)
+sm agents           # List all supported agents
 ```
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
-| `sm download` | Download a skill from GitHub |
+| `sm install [url]` | Download and deploy skills (with discovery) |
+| `sm download [url]` | Download a skill from GitHub |
 | `sm deploy` | Deploy local skills to agents |
-| `sm install` | Download and deploy in one step |
+| `sm discover [url]` | Discover all skills in a repository |
 | `sm uninstall` | Remove skills (safe delete/hard delete) |
 | `sm restore` | Restore deleted skills from trash |
-| `sm update` | Update selected skills from GitHub |
-| `sm update --all` | Update all GitHub-sourced skills |
+| `sm update [--all]` | Update skills from GitHub |
 | `sm list` | Show installed skills with versions |
+| `sm agents` | List all supported agents |
 | `sm --version` / `sm -v` | Show version information |
 
+## CLI Options
+
+| Option | Description |
+|--------|-------------|
+| `-a, --agent AGENT` | Target agent(s), can be specified multiple times |
+| `-t, --type TYPE` | Deployment type: `global` (default) or `project` |
+| `-d, --dest PATH` | Custom destination directory for downloads |
+| `--no-symlink` | Disable symlinks, copy files instead (symlinks on by default) |
+| `--no-discover` | Disable auto-discovery (on by default) |
+| `--no-deploy` | Download only, skip deployment |
+| `-y, --yes` | Skip confirmation prompts |
+
 ## Usage Examples
 
-### Install a skill from GitHub
+### Install all skills from a repository
+
+```bash
+# Install all skills from a repo (auto-discovery and symlinks enabled by default)
+sm install https://github.com/cloudflare/skills -a windsurf -a cursor
+
+# Use symlinks to save disk space (enabled by default, use --no-symlink to disable)
+sm install https://github.com/cloudflare/skills -a claude-code
+
+# Full CLI mode - no prompts
+sm install https://github.com/user/repo/tree/main/skills/my-skill -a claude-code -t global
+
+# Disable auto-discovery to install only the specific path
+sm install https://github.com/user/repo/tree/main/skills/my-skill --no-discover -a cursor
+
+# Disable symlinks, copy files instead
+sm install https://github.com/cloudflare/skills --no-symlink -a windsurf
+
+# Download to custom location
+sm install https://github.com/user/repo/tree/main/skills/my-skill -d ./my-skills -a cursor
+```
+
+### Discover skills in a repository
+
+```bash
+# Scan a repository to find all skills
+sm discover https://github.com/cloudflare/skills
+# Shows a table of all found skills with their paths
+```
+
+### Interactive mode (legacy)
 
 ```bash
 sm install
-# Enter URL: https://github.com/user/repo/tree/main/skills/example-skill
+# Enter URL when prompted
 # Follow the prompts to save locally and deploy
 ```
 
@@ -187,6 +272,21 @@ sm uninstall
 sm restore
 ```
 
+### Using symlinks
+
+Symlinks allow you to maintain a single copy of skills while deploying to multiple agents:
+
+```bash
+# Download skills to a central location and symlink to agents (default behavior)
+sm install https://github.com/cloudflare/skills -d ~/skills -a windsurf -a cursor -a claude-code
+
+# Disable symlinks if needed
+sm install https://github.com/cloudflare/skills --no-symlink -a windsurf
+```
+
+> [!NOTE]
+> On Windows, symlinks require Developer Mode or administrator privileges. If symlinks are not supported, the tool will automatically fall back to copying.
+
 ## Version Tracking
 
 The tool uses two methods for version identification:

agent_skill_manager-0.2.1.dist-info/RECORD

@@ -0,0 +1,12 @@
+skill_manager/__init__.py,sha256=l5Bfi0z6Vd5LEtgjsbP-zOYBifhKUWQGsj8DhzeTdFE,2137
+skill_manager/agents.py,sha256=fGdYBREM5Kw_Djx8z_0pbe2V_-mSYngZRdJ86s8W-PU,8157
+skill_manager/cli.py,sha256=4wbQFY0AUK81MFMQ7BXje2QPsJH7yMd12Y-rHgAvaDk,55647
+skill_manager/deployment.py,sha256=YitXCJO8tje2mq34qS9qyxDrfQJbth9GiM3-3UPWT8I,10878
+skill_manager/github.py,sha256=n2A6zId3T4lR-C5JKF9OTPQ9ptnnCWsWL2C8s2ziB2I,9232
+skill_manager/metadata.py,sha256=PZrKsGMyBDEqrV93lXlc5z9xXRxxI24FhSHmWCvXltU,3503
+skill_manager/removal.py,sha256=WeVdTszBVX8shnVP_ueuAAuZOYjoSHLNDfNCR1haakc,8042
+skill_manager/validation.py,sha256=fRUJDs4TiuKlH3doey31SPJfe671JJQcBFSAhJwoSIE,1970
+agent_skill_manager-0.2.1.dist-info/METADATA,sha256=HJLy4t8RMzAk4QJzO8slQ2zuE-iZnFjVIDOtLqn7Y_Q,12776
+agent_skill_manager-0.2.1.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+agent_skill_manager-0.2.1.dist-info/entry_points.txt,sha256=ac3L07OC98p1llk259d9PUhDp-cl3ifV2nmYHGb3WO8,85
+agent_skill_manager-0.2.1.dist-info/RECORD,,

skill_manager/__init__.py

@@ -5,18 +5,25 @@ This package provides functionality to download, deploy, and manage
 skills across different AI agent platforms.
 """
 
-__version__ = "0.1.3"
+__version__ = "0.2.1"
 
-from .agents import AGENTS, detect_existing_agents, get_agent_name, get_agent_path
+from .agents import AGENTS, detect_existing_agents, get_agent_name, get_agent_path, supports_global_deployment
 from .deployment import (
+    create_symlink,
     deploy_multiple_skills,
     deploy_skill,
     deploy_skill_to_agents,
+    is_skill_symlink,
+    is_symlink_supported,
+    remove_symlink,
     update_all_skills,
     update_skill,
 )
 from .github import (
+    discover_skills_in_repo,
+    download_multiple_skills,
     download_skill_from_github,
+    get_system_temp_dir,
     parse_github_url,
 )
 from .metadata import (
@@ -49,14 +56,22 @@ __all__ = [
     "detect_existing_agents",
     "get_agent_name",
     "get_agent_path",
+    "supports_global_deployment",
     # Deployment
     "deploy_skill",
     "deploy_skill_to_agents",
     "deploy_multiple_skills",
     "update_skill",
     "update_all_skills",
+    "is_symlink_supported",
+    "create_symlink",
+    "remove_symlink",
+    "is_skill_symlink",
     # GitHub
     "download_skill_from_github",
+    "download_multiple_skills",
+    "discover_skills_in_repo",
+    "get_system_temp_dir",
     "parse_github_url",
     # Metadata
     "save_skill_metadata",

skill_manager/agents.py

@@ -8,77 +8,241 @@ from pathlib import Path
 
 # Agent configuration mapping
 # Each agent has a name, project-level path, and global path
+# Note: global=None means project-only (no global installation supported)
 AGENTS = {
-    "opencode": {
-        "name": "OpenCode",
-        "project": ".opencode/skills/",
-        "global": "~/.config/opencode/skills/",
+    # Amp, Kimi Code CLI
+    "amp": {
+        "name": "Amp",
+        "project": ".agents/skills/",
+        "global": "~/.config/agents/skills/",
+    },
+    "kimi-cli": {
+        "name": "Kimi Code CLI",
+        "project": ".agents/skills/",
+        "global": "~/.config/agents/skills/",
+    },
+    # Antigravity
+    "antigravity": {
+        "name": "Antigravity",
+        "project": ".agent/skills/",
+        "global": "~/.gemini/antigravity/skills/",
     },
+    # Augment
+    "augment": {
+        "name": "Augment",
+        "project": ".augment/rules/",
+        "global": "~/.augment/rules/",
+    },
+    # Claude Code
     "claude-code": {
         "name": "Claude Code",
         "project": ".claude/skills/",
         "global": "~/.claude/skills/",
     },
+    # OpenClaw
+    "openclaw": {
+        "name": "OpenClaw",
+        "project": "skills/",
+        "global": "~/.moltbot/skills/",
+    },
+    # Cline
+    "cline": {
+        "name": "Cline",
+        "project": ".cline/skills/",
+        "global": "~/.cline/skills/",
+    },
+    # CodeBuddy
+    "codebuddy": {
+        "name": "CodeBuddy",
+        "project": ".codebuddy/skills/",
+        "global": "~/.codebuddy/skills/",
+    },
+    # Codex
     "codex": {
         "name": "Codex",
-        "project": ".codex/skills/",
+        "project": ".agents/skills/",
         "global": "~/.codex/skills/",
     },
+    # Command Code
+    "command-code": {
+        "name": "Command Code",
+        "project": ".commandcode/skills/",
+        "global": "~/.commandcode/skills/",
+    },
+    # Continue
+    "continue": {
+        "name": "Continue",
+        "project": ".continue/skills/",
+        "global": "~/.continue/skills/",
+    },
+    # Crush
+    "crush": {
+        "name": "Crush",
+        "project": ".crush/skills/",
+        "global": "~/.config/crush/skills/",
+    },
+    # Cursor
     "cursor": {
         "name": "Cursor",
         "project": ".cursor/skills/",
         "global": "~/.cursor/skills/",
     },
-    "amp": {
-        "name": "Amp",
+    # Droid
+    "droid": {
+        "name": "Droid",
+        "project": ".factory/skills/",
+        "global": "~/.factory/skills/",
+    },
+    # Gemini CLI
+    "gemini-cli": {
+        "name": "Gemini CLI",
         "project": ".agents/skills/",
-        "global": "~/.config/agents/skills/",
+        "global": "~/.gemini/skills/",
     },
+    # GitHub Copilot
+    "github-copilot": {
+        "name": "GitHub Copilot",
+        "project": ".agents/skills/",
+        "global": "~/.copilot/skills/",
+    },
+    # Goose
+    "goose": {
+        "name": "Goose",
+        "project": ".goose/skills/",
+        "global": "~/.config/goose/skills/",
+    },
+    # Junie
+    "junie": {
+        "name": "Junie",
+        "project": ".junie/skills/",
+        "global": "~/.junie/skills/",
+    },
+    # iFlow CLI
+    "iflow-cli": {
+        "name": "iFlow CLI",
+        "project": ".iflow/skills/",
+        "global": "~/.iflow/skills/",
+    },
+    # Kilo Code
     "kilo": {
         "name": "Kilo Code",
         "project": ".kilocode/skills/",
         "global": "~/.kilocode/skills/",
     },
-    "roo": {
-        "name": "Roo Code",
-        "project": ".roo/skills/",
-        "global": "~/.roo/skills/",
+    # Kiro CLI
+    "kiro-cli": {
+        "name": "Kiro CLI",
+        "project": ".kiro/skills/",
+        "global": "~/.kiro/skills/",
     },
-    "goose": {
-        "name": "Goose",
-        "project": ".goose/skills/",
-        "global": "~/.config/goose/skills/",
+    # Kode
+    "kode": {
+        "name": "Kode",
+        "project": ".kode/skills/",
+        "global": "~/.kode/skills/",
     },
-    "gemini-cli": {
-        "name": "Gemini CLI",
-        "project": ".gemini/skills/",
-        "global": "~/.gemini/skills/",
+    # MCPJam
+    "mcpjam": {
+        "name": "MCPJam",
+        "project": ".mcpjam/skills/",
+        "global": "~/.mcpjam/skills/",
     },
-    "antigravity": {
-        "name": "Antigravity",
-        "project": ".agent/skills/",
-        "global": "~/.gemini/antigravity/skills/",
+    # Mistral Vibe
+    "mistral-vibe": {
+        "name": "Mistral Vibe",
+        "project": ".vibe/skills/",
+        "global": "~/.vibe/skills/",
     },
-    "github-copilot": {
-        "name": "GitHub Copilot",
-        "project": ".github/skills/",
-        "global": "~/.copilot/skills/",
+    # Mux
+    "mux": {
+        "name": "Mux",
+        "project": ".mux/skills/",
+        "global": "~/.mux/skills/",
     },
-    "clawdbot": {
-        "name": "Clawdbot",
-        "project": "skills/",
-        "global": "~/.clawdbot/skills/",
+    # OpenCode
+    "opencode": {
+        "name": "OpenCode",
+        "project": ".agents/skills/",
+        "global": "~/.config/opencode/skills/",
     },
-    "droid": {
-        "name": "Droid",
-        "project": ".factory/skills/",
-        "global": "~/.factory/skills/",
+    # OpenHands
+    "openhands": {
+        "name": "OpenHands",
+        "project": ".openhands/skills/",
+        "global": "~/.openhands/skills/",
+    },
+    # Pi
+    "pi": {
+        "name": "Pi",
+        "project": ".pi/skills/",
+        "global": "~/.pi/agent/skills/",
+    },
+    # Qoder
+    "qoder": {
+        "name": "Qoder",
+        "project": ".qoder/skills/",
+        "global": "~/.qoder/skills/",
+    },
+    # Qwen Code
+    "qwen-code": {
+        "name": "Qwen Code",
+        "project": ".qwen/skills/",
+        "global": "~/.qwen/skills/",
     },
+    # Replit (project-only)
+    "replit": {
+        "name": "Replit",
+        "project": ".agents/skills/",
+        "global": None,
+    },
+    # Roo Code
+    "roo": {
+        "name": "Roo Code",
+        "project": ".roo/skills/",
+        "global": "~/.roo/skills/",
+    },
+    # Trae
+    "trae": {
+        "name": "Trae",
+        "project": ".trae/skills/",
+        "global": "~/.trae/skills/",
+    },
+    # Trae CN
+    "trae-cn": {
+        "name": "Trae CN",
+        "project": ".trae/skills/",
+        "global": "~/.trae-cn/skills/",
+    },
+    # Windsurf
     "windsurf": {
         "name": "Windsurf",
         "project": ".windsurf/skills/",
         "global": "~/.codeium/windsurf/skills/",
     },
+    # Zencoder
+    "zencoder": {
+        "name": "Zencoder",
+        "project": ".zencoder/skills/",
+        "global": "~/.zencoder/skills/",
+    },
+    # Neovate
+    "neovate": {
+        "name": "Neovate",
+        "project": ".neovate/skills/",
+        "global": "~/.neovate/skills/",
+    },
+    # Pochi
+    "pochi": {
+        "name": "Pochi",
+        "project": ".pochi/skills/",
+        "global": "~/.pochi/skills/",
+    },
+    # AdaL
+    "adal": {
+        "name": "AdaL",
+        "project": ".adal/skills/",
+        "global": "~/.adal/skills/",
+    },
 }
 
 
@@ -91,7 +255,10 @@ def detect_existing_agents() -> dict[str, Path]:
     """
     existing = {}
     for agent_id, info in AGENTS.items():
-        global_path = Path(info["global"]).expanduser()
+        global_path = info.get("global")
+        if global_path is None:
+            continue
+        global_path = Path(global_path).expanduser()
         if global_path.exists():
             existing[agent_id] = global_path
     return existing
@@ -108,6 +275,9 @@ def get_agent_path(agent_id: str, deployment_type: str = "global", project_root:
 
     Returns:
         The target path for the agent
+
+    Raises:
+        ValueError: If the agent doesn't support global deployment (global=None)
     """
     if agent_id not in AGENTS:
         raise ValueError(f"Unknown agent: {agent_id}")
@@ -115,13 +285,31 @@ def get_agent_path(agent_id: str, deployment_type: str = "global", project_root:
     info = AGENTS[agent_id]
 
     if deployment_type == "global":
-        return Path(info["global"]).expanduser()
+        global_path = info.get("global")
+        if global_path is None:
+            raise ValueError(f"Agent '{agent_id}' does not support global deployment (project-only)")
+        return Path(global_path).expanduser()
     else:
         if project_root is None:
             project_root = Path.cwd()
         return project_root / info["project"]
 
 
+def supports_global_deployment(agent_id: str) -> bool:
+    """
+    Check if an agent supports global deployment.
+
+    Args:
+        agent_id: The agent identifier
+
+    Returns:
+        True if the agent supports global deployment, False otherwise
+    """
+    if agent_id not in AGENTS:
+        raise ValueError(f"Unknown agent: {agent_id}")
+    return AGENTS[agent_id].get("global") is not None
+
+
 def get_agent_name(agent_id: str) -> str:
     """
     Get the display name for an agent.