skills-manager
SKILL.md
Skills Manager
Quick Reference
| Task | Command |
|---|---|
| List all | python3 scripts/list_skills.py |
| List by scope | python3 scripts/list_skills.py -s user or -s project |
| Show details | python3 scripts/show_skill.py <name> |
| Review skill | python3 scripts/review_skill.py <name> |
| Delete | python3 scripts/delete_skill.py <name> |
| Move to user | python3 scripts/move_skill.py <name> user |
| Move to project | python3 scripts/move_skill.py <name> project |
| Create new | Use /skill-creator |
| Multi-Agent | |
| Detect agents | python3 scripts/detect_agents.py |
| List agent skills | python3 scripts/list_agent_skills.py --agent cursor |
| Install to agent | python3 scripts/install_skill.py /path --agent cursor |
| Copy between agents | python3 scripts/copy_skill.py <name> --from claude-code --to cursor |
| Move between agents | python3 scripts/move_skill_agent.py <name> --from claude-code --to cursor |
Scopes
| Scope | Path | Visibility |
|---|---|---|
| User | ~/.claude/skills/ |
All projects for this user |
| Project | .claude/skills/ |
This repository only |
User scope takes precedence over project scope for skills with the same name.
Operations
List Skills
python3 scripts/list_skills.py # All skills
python3 scripts/list_skills.py -s user # User scope only
python3 scripts/list_skills.py -f json # JSON output
Show Skill Details
python3 scripts/show_skill.py <name> # Basic info
python3 scripts/show_skill.py <name> --files # Include file listing
python3 scripts/show_skill.py <name> -f json # JSON output
Review Skill
Audits a skill against best practices and suggests improvements:
python3 scripts/review_skill.py <name> # Review with text output
python3 scripts/review_skill.py <name> -f json # JSON output for programmatic use
Checks performed:
- Name format (lowercase, hyphens, max 64 chars, gerund form)
- Description quality (triggers, third person, specificity)
- Body length (warns if >500 lines)
- Time-sensitive content
- Path format (no Windows backslashes)
- Reference depth (should be one level)
- Table of contents for long files
After reviewing: Read the skill's SKILL.md and apply the suggested fixes directly.
Delete Skill
CRITICAL: Always use AskUserQuestion to confirm before deleting: "Are you sure you want to delete the skill '[name]'? This cannot be undone."
python3 scripts/delete_skill.py <name> # With script confirmation
python3 scripts/delete_skill.py <name> --force # Skip script prompt
python3 scripts/delete_skill.py <name> -s project # Target specific scope
Move Skill
python3 scripts/move_skill.py <name> user # Project → User (personal)
python3 scripts/move_skill.py <name> project # User → Project (share with team)
python3 scripts/move_skill.py <name> user -f # Overwrite if exists
Modify Skill
- Run
python3 scripts/show_skill.py <name>to locate it - Edit SKILL.md directly at the returned path
Create New Skill
Use the /skill-creator skill for guided creation with proper structure.
Multi-Agent Operations
Manage skills across 15 supported AI coding agents.
Supported Agents
| Agent ID | Display Name | Project Skills Dir | Global Skills Dir |
|---|---|---|---|
opencode |
OpenCode | .opencode/skill |
~/.config/opencode/skill |
claude-code |
Claude Code | .claude/skills |
~/.claude/skills |
codex |
Codex | .codex/skills |
~/.codex/skills |
cursor |
Cursor | .cursor/skills |
~/.cursor/skills |
amp |
Amp | .agents/skills |
~/.config/agents/skills |
kilo |
Kilo Code | .kilocode/skills |
~/.kilocode/skills |
roo |
Roo Code | .roo/skills |
~/.roo/skills |
goose |
Goose | .goose/skills |
~/.config/goose/skills |
gemini-cli |
Gemini CLI | .gemini/skills |
~/.gemini/skills |
antigravity |
Antigravity | .agent/skills |
~/.gemini/antigravity/skills |
github-copilot |
GitHub Copilot | .github/skills |
~/.copilot/skills |
clawdbot |
Clawdbot | skills |
~/.clawdbot/skills |
droid |
Droid | .factory/skills |
~/.factory/skills |
windsurf |
Windsurf | .windsurf/skills |
~/.codeium/windsurf/skills |
Detect Installed Agents
python3 scripts/detect_agents.py # List detected agents
python3 scripts/detect_agents.py --all # Show all supported agents
python3 scripts/detect_agents.py -f json # JSON output
List Skills for Any Agent
python3 scripts/list_agent_skills.py --agent cursor # Single agent
python3 scripts/list_agent_skills.py --agent goose -s global # Specific scope
python3 scripts/list_agent_skills.py --all # All detected agents
python3 scripts/list_agent_skills.py --agent amp -f json # JSON output
Install Skill to Agents
python3 scripts/install_skill.py /path/to/skill --agent cursor # Single agent
python3 scripts/install_skill.py /path/to/skill --agent cursor --agent amp # Multiple agents
python3 scripts/install_skill.py /path/to/skill --all # All detected
python3 scripts/install_skill.py /path/to/skill --agent goose -s global # Global scope
python3 scripts/install_skill.py /path/to/skill --agent cursor --force # Overwrite
Copy Skill Between Agents
python3 scripts/copy_skill.py my-skill --from claude-code --to cursor
python3 scripts/copy_skill.py my-skill --from claude-code --to cursor --to-scope global
python3 scripts/copy_skill.py my-skill --from claude-code --from-scope project --to amp
python3 scripts/copy_skill.py my-skill --from claude-code --to cursor --force
Move Skill Between Agents
python3 scripts/move_skill_agent.py my-skill --from claude-code --to cursor
python3 scripts/move_skill_agent.py my-skill --from claude-code --to goose --force
Important Notes
- Restart required: After adding, removing, or moving skills, restart the AI agent for changes to take effect
- Edits are immediate: Changes to existing skill content work without restart
- Agent detection: Uses config directory presence to detect installed agents
Acknowledgments
Multi-agent support is based on add-skill by Vercel Labs.