---

name: skill-manager description: >- Unified skill management for AI IDEs. Use when users want to: list skills ("what skills do I have", "show installed skills"), search skills ("find skills for X", "search for PDF skill"), install skills ("install a skill", "add skill from GitHub"), create skills ("create a new skill", "make a skill"), sync skills ("sync to all IDEs", "push skills"), remove skills ("remove skill X", "uninstall skill"), validate skills ("validate my skills", "check skill format"), export/import profiles ("export my skills", "import profile", "sync across machines"). Supports 5 IDEs: Claude Code, Cursor, Codex, Gemini CLI, Antigravity. IMPORTANT: When creating or modifying skills, always follow the guidelines in references/skill-creator/SKILL.md.

Skill Manager

Unified CLI for managing AI skills across all IDEs.

IMPORTANT: Skill Guidelines Reference

When creating, installing, or modifying skills, ALWAYS read and follow:

references/skill-creator/SKILL.md

This is the authoritative guide for skill structure, including:

• Concise is Key principle
• Progressive Disclosure pattern
• YAML frontmatter requirements
• File organization rules
• Anti-patterns to avoid

Important Paths

• Source (SSOT): ~/.ai-skills/ - Single Source of Truth
• Guidelines: ~/.ai-skills/skill-manager/references/skill-creator/SKILL.md
• Claude Code: ~/.claude/skills/
• Cursor: ~/.cursor/skills/
• Codex: ~/.codex/skills/
• Gemini CLI: ~/.gemini/skills/
• Antigravity: ~/.gemini/antigravity/skills/
• Config: ~/.ai-skills/skill-manager/config.json

Quick Reference

Usage Examples

User: "What skills do I have installed?"

Copypython ~/.ai-skills/skill-manager/scripts/skills list --json

User: "Find me a skill for working with Docker"

Copypython ~/.ai-skills/skill-manager/scripts/skills search "docker"

User: "Install the docx skill from anthropics"

Copypython ~/.ai-skills/skill-manager/scripts/skills install https://github.com/anthropics/skills/tree/main/skills/docx

User: "Create a skill for formatting SQL"

Copypython ~/.ai-skills/skill-manager/scripts/skills create sql-formatter

User: "Sync my skills to all IDEs"

Copypython ~/.ai-skills/skill-manager/scripts/skills sync

User: "Export my skills to share with another machine"

Copypython ~/.ai-skills/skill-manager/scripts/skills export --gist

Commands

skills (no args) - Interactive Menu

When called without arguments, displays interactive menu:

Copy╔════════════════════════════════════════════════════╗
║         Skill Manager - Interactive Mode           ║
╠════════════════════════════════════════════════════╣
║ Installed Skills: 15                               ║
║ Enabled IDEs: claude, cursor, codex, gemini        ║
╚════════════════════════════════════════════════════╝

1. List installed skills
2. Search community skills
3. Install a skill
...

skills search

Search community skills database.

Copypython ~/.ai-skills/skill-manager/scripts/skills search "python testing"

skills install

Install from GitHub URL or search results.

Copy# From URL
python ~/.ai-skills/skill-manager/scripts/skills install https://github.com/anthropics/skills/tree/main/skills/docx

# From search
python ~/.ai-skills/skill-manager/scripts/skills install --query "pdf" --index 1

skills create

Create new skill from template (follows skill-creator guidelines).

Copypython ~/.ai-skills/skill-manager/scripts/skills create my-skill --resources scripts,references

skills sync

Sync skills to all enabled IDEs.

Copy# Sync all
python ~/.ai-skills/skill-manager/scripts/skills sync

# Sync single skill
python ~/.ai-skills/skill-manager/scripts/skills sync my-skill

# Dry run
python ~/.ai-skills/skill-manager/scripts/skills sync --dry-run

skills validate

Validate skills against guidelines and verify sync.

Copypython ~/.ai-skills/skill-manager/scripts/skills validate my-skill

skills export / import

Export and import skill profiles for cross-machine sync.

Copy# Export to Gist
python ~/.ai-skills/skill-manager/scripts/skills export --gist

# Import from Gist
python ~/.ai-skills/skill-manager/scripts/skills import --gist <gist-id>

Scope Flags

• -g, --global: Global scope (~/.ai-skills/)
• -l, --local: Project scope (.ai-skills/)

Error Handling

Configuration

Edit ~/.ai-skills/skill-manager/config.json to customize:

• git.auto_commit: Enable/disable auto commit (default: true)
• git.auto_push: Enable/disable auto push (default: false)
• sync.auto_after_install: Auto sync after install (default: true)
• enabled_ides: List of IDEs to sync to
• exclude_skills: Skills to exclude from sync
• preserve_target_skills: Directories to preserve in targets (e.g., Codex .system/)

For Creating Skills

Always refer to: references/skill-creator/SKILL.md