Search, install, lint, and manage SKILL.md files from your terminal. Works with Claude, Codex, and any agent that reads markdown.
SKILL.md files teach agents what to do — but they're scattered across repos, folders, and Slack threads. No search. No versioning. No quality checks.
Local skills, trusted registries, and GitHub — merged into one ranked table. Synonym expansion finds "xlsx" when you search "excel".
Clone, symlink, register. Monorepo-aware with --path. Reference-counted clones protect siblings.
Score a SKILL.md 0–100 against 8 quality checks. Returns specific fixes for each failing check.
Three guides: skill anatomy, writing for AI comprehension, and directory structure. Never leave the terminal.
Every command supports --json. Responses include next_actions arrays — valid follow-up commands the agent can execute.
SHA-tracked. Only new or changed skills get re-indexed. Optional LLM enrichment at ~$0.0005/skill.
| skillctl search "query" | Find skills across local, registries, and GitHub |
| skillctl install user/repo | Clone, symlink, and register a skill |
| skillctl list | Show installed skills with timestamps |
| skillctl info skill-name | Detailed skill card — author, tags, repo, status |
| skillctl create my-skill | Scaffold a new SKILL.md from template |
| skillctl update --all | Pull latest for git-installed skills |
| skillctl remove skill-name | Uninstall with reference-counted cleanup |
| skillctl lint skill-name | Score a skill 0–100 against 8 quality checks |
| skillctl learn | Built-in guides: anatomy, writing, organizing skills |
| skillctl registry | Manage trusted skill registries |
| skillctl config | View and set configuration |
| skillctl schema | Dump full CLI schema as JSON for agents |
Then run skillctl learn to get started.