gh-skill — Skill Registry
Search, install, and manage AI agent skills using the gh skill CLI extension.
When to Use
- •User asks for a capability you don't have ("I need a weather skill", "find me a skill for X")
- •User wants to browse available skills
- •User asks to install, update, or remove skills
- •You need a specialized skill for a task and suspect one exists
Searching for Skills
bash
gh skill search <query> # search public skills by keyword gh skill search weather # example: find weather skills gh skill search --tag <tag> # filter by tag
Review results and suggest the best match. Check description, author, and star count.
Installing Skills
bash
gh skill add <gist-url-or-id> # install + auto-link to all detected tools gh skill add <gist-url-or-id> --yes # skip trust prompt
After install, the skill is immediately available in your skill directory. No restart needed.
Managing Skills
bash
gh skill list # show all installed skills gh skill info <name> # show metadata for a skill gh skill update <name> # pull latest version gh skill update --all # update all installed skills gh skill remove <name> # uninstall + remove symlinks
Workflow
- •Search for what you need:
gh skill search <query> - •Review the results — check description and author
- •Install the best match:
gh skill add <id> - •Confirm it's linked:
gh skill list - •Use it — the skill is now in your available skills
Notes
- •Skills are backed by GitHub Gists and discovered via the
[gh-skill]prefix convention - •Installed skills live in
~/.gistskills/and are symlinked to your tool's skill directory - •Trust gate: you'll be prompted before installing from untrusted authors
- •Always tell the user what you found and let them decide before installing