agent-skill-manager 0.1.2__py3-none-any.whl → 0.2.0__py3-none-any.whl

agent_skill_manager-0.2.0.dist-info/METADATA

@@ -0,0 +1,388 @@
+Metadata-Version: 2.4
+Name: agent-skill-manager
+Version: 0.2.0
+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
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: rich>=14.2.0
+Description-Content-Type: text/markdown
+
+# Agent Skill Manager
+
+ALL codes are written by Claude Code.
+
+A comprehensive CLI tool for managing AI agent skills across multiple platforms. Download, deploy, update, and manage skills for AI coding assistants like Claude Code, Cursor, Windsurf, and more.
+
+[![PyPI version](https://badge.fury.io/py/agent-skill-manager.svg)](https://pypi.org/project/agent-skill-manager/)
+[![Python 3.13+](https://img.shields.io/badge/python-3.13+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- 📥 **Download** skills from GitHub with metadata tracking
+- � **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
+
+<!-- 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
+
+### Recommended: Install with uv tool
+
+The best way to install is using `uv tool`:
+
+```bash
+# Install from PyPI
+uv tool install agent-skill-manager
+
+# Verify installation
+sm --version
+
+# Start using
+sm install
+```
+
+**Why uv tool?**
+- Isolated environment (no package conflicts)
+- Easy updates: `uv tool upgrade agent-skill-manager`
+- Clean uninstall: `uv tool uninstall agent-skill-manager`
+- Works across all projects
+
+### Alternative: Run Without Installing
+
+For one-time use or testing:
+
+```bash
+# Run directly with uvx (no installation needed)
+uvx agent-skill-manager
+
+# Or run specific commands
+uvx --from agent-skill-manager sm install
+uvx --from agent-skill-manager sm list
+```
+
+### Other Installation Methods
+
+```bash
+# Using pip
+pip install agent-skill-manager
+
+# Using pipx (isolated like uv tool)
+pipx install agent-skill-manager
+
+# From source (for development)
+git clone https://github.com/ackness/skill-manager.git
+cd skill-manager
+uv sync
+uv pip install -e .
+```
+
+## Usage Methods Comparison
+
+| 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 |
+
+## Quick Start
+
+```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 (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 install [url]` | Download and deploy skills (with discovery) |
+| `sm download [url]` | Download a skill from GitHub |
+| `sm deploy` | Deploy local skills to agents |
+| `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 [--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 |
+| `--symlink` | Use symlinks instead of copying files |
+| `--discover` | Discover and install all skills in repository |
+| `--no-deploy` | Download only, skip deployment |
+| `-y, --yes` | Skip confirmation prompts |
+
+## Usage Examples
+
+### Install all skills from a repository
+
+```bash
+# Discover and install all skills from a repository
+sm install https://github.com/cloudflare/skills --discover -a windsurf -a cursor
+
+# Use symlinks to save disk space (single source, multiple agents)
+sm install https://github.com/cloudflare/skills --discover --symlink -a windsurf
+```
+
+### Install a single skill with CLI options
+
+```bash
+# Full CLI mode - no prompts
+sm install https://github.com/user/repo/tree/main/skills/my-skill -a claude-code -t global
+
+# 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 when prompted
+# Follow the prompts to save locally and deploy
+```
+
+### Update all skills
+
+```bash
+sm update --all
+# Automatically updates all skills installed from GitHub
+```
+
+### List installed skills with versions
+
+```bash
+sm list
+# Shows a table for each agent with:
+# - Skill Name
+# - Version/Updated timestamp
+# - Source (GitHub/Local)
+# - GitHub URL (for updatable skills)
+```
+
+### Safe delete and restore
+
+```bash
+# Uninstall with safe delete (default)
+sm uninstall
+
+# Restore if needed
+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
+sm install https://github.com/cloudflare/skills --discover -d ~/skills --symlink -a windsurf -a cursor -a claude-code
+```
+
+> [!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:
+
+1. **GitHub Metadata** (for installed skills)
+   - Tracks installation and update timestamps
+   - Stores repository information
+   - Enables automatic updates
+
+2. **File Modification Time** (for local skills)
+   - Uses SKILL.md modification time as fallback
+   - For skills without metadata
+
+## Directory Structure
+
+### Global Installation
+Skills are available to all projects:
+```
+~/.claude/skills/           # Claude Code
+~/.cursor/skills/           # Cursor
+~/.codeium/windsurf/skills/ # Windsurf
+# ... other agents
+```
+
+### Project Installation
+Skills are only available in the current project:
+```
+project-root/
+  .claude/skills/
+  .cursor/skills/
+  # ... other agents
+```
+
+## Configuration
+
+Each skill installed from GitHub includes metadata in `.skill_metadata.json`:
+
+```json
+{
+  "source": "github",
+  "github_url": "https://github.com/...",
+  "owner": "user",
+  "repo": "repo-name",
+  "branch": "main",
+  "path": "skills/skill-name",
+  "installed_at": "2026-01-20T14:30:52+00:00",
+  "updated_at": "2026-01-20T14:30:52+00:00"
+}
+```
+
+## Development
+
+### Adding Support for New Agents
+
+Edit `src/skill_manager/agents.py` and add the agent configuration:
+
+```python
+"agent-id": {
+    "name": "Agent Name",
+    "project": ".agent/skills/",
+    "global": "~/.agent/skills/",
+}
+```
+
+### Running Tests
+
+```bash
+uv run pytest
+```
+
+### Code Formatting
+
+```bash
+uv run ruff format .
+uv run ruff check . --fix
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## Related Projects
+
+- [Agent Skills Specification](https://agentskills.io/specification)
+- [Agent Skills Registry](https://agentskills.io)
+
+## License
+
+MIT License - See [LICENSE](LICENSE) file for details
+
+## Author
+
+**ackness** - [ackness8@gmail.com](mailto:ackness8@gmail.com)
+
+## Acknowledgments
+
+- Built following the [Agent Skills specification](https://agentskills.io/specification)
+- Supports all major AI coding assistants

agent_skill_manager-0.2.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+skill_manager/__init__.py,sha256=GrUMVTBjFlrDShb812PAYjFLsK4myiLv6DUXJcyjHZs,2137
+skill_manager/agents.py,sha256=fGdYBREM5Kw_Djx8z_0pbe2V_-mSYngZRdJ86s8W-PU,8157
+skill_manager/cli.py,sha256=eqI9qa9Iq4gzyqXRGfsT_uyxk3AajmTCSdN9indEqqY,55564
+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.0.dist-info/METADATA,sha256=LzXAjCX67GUeOwUErW7-YI9xoDijv5ENP3kFee4w5BA,12428
+agent_skill_manager-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+agent_skill_manager-0.2.0.dist-info/entry_points.txt,sha256=ac3L07OC98p1llk259d9PUhDp-cl3ifV2nmYHGb3WO8,85
+agent_skill_manager-0.2.0.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.0"
+__version__ = "0.2.0"
 
-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",