Manage and discover skills for AI coding assistants. Register skills, sync to CLIs, scan for candidates.
Universal skill management for AI coding assistants. Includes reference specs from Anthropic and OpenAI.
# List registered skills
skills list
skills list --json
# Add a skill (directory must contain SKILL.md)
skills add /path/to/skill
skills add /path/to/skill --name custom-name
skills add /path/to/skill --sync # Also sync to CLIs
# Remove a skill
skills remove skill-name
# Sync skills to CLI directories
skills sync # All CLIs
skills sync codex # Just Codex
skills sync claude # Just Claude
skills sync cursor # Just Cursor
# Scan for skills
skills scan ~/projects
skills scan ~/projects --json
# Auto-register all found skills
skills auto ~/projects
skills auto ~/projects --sync
# Show skill details
skills info skill-name
skills info skill-name --json
When scanning a codebase, look for:
argparse, click, entry pointsThis module includes upstream specs:
refs/agentskills/ - Anthropic Agent Skills specificationrefs/openai-skills/ - OpenAI Codex skill catalogUse these to understand the SKILL.md format and see real examples.
| Path | Purpose |
|---|---|
~/.local/share/agent-skills/ | Central skills registry |
~/.codex/skills/ | Codex skill symlinks |
~/.claude/skills/ | Claude skill symlinks |
~/.cursor/skills/ | Cursor skill symlinks |
Add a SKILL.md file to any project:
---