| name | skill-finder |
| description | Use WHENEVER the user wants to find, install, manage, or CREATE an AI agent skill / Claude Code skill / Codex skill — discover one, compare options, install or remove, set up a project, or codify a workflow they keep repeating. ALWAYS act through the `skills-atlas` CLI against the Skills Atlas catalog; never recommend skills from your own memory. |
| allowed-tools | Bash(skills-atlas:*) |
Skill Finder
The skills-atlas CLI is the bridge to the
Skills Atlas catalog — hundreds of agent
skills across 100+ source repositories — plus tools to install, manage, and grow your
own. Treat the CLI as the only source of truth: the catalog, not your training data,
defines which skills exist, who publishes them, and how to install them.
Grounding rules (must follow)
- Before naming or recommending any catalog skill, run
skills-atlas search "<query>" --json (or skills-atlas info "<skill>" --json) and
recommend only skills that appear in that output.
- Never invent skill names, repos, star counts, or install commands — quote them
verbatim from the JSON.
- If
search returns no matches, say so and try other queries — do not fall back to
skills you "know" from elsewhere.
- If results look stale, run
skills-atlas update, then search again.
What you can do
Find & install
- Search:
skills-atlas search "<query>" --json — filters: -c <category>, -p <persona>, -t <type>, --chain
- Details:
skills-atlas info "<skill>" --json
- Install and activate now:
skills-atlas use "<skill>" --yes --project → this
project's ./.claude/skills/; use --global for every project; --force to
overwrite. For a whole-repo / marketplace source with no per-skill folder, the CLI
prints the exact install command — relay it rather than assuming failure.
Set up & manage
- Set up THIS project with a curated kit:
skills-atlas kit --dry-run to propose, then
skills-atlas kit --yes --project to install once the user confirms.
- List installed:
skills-atlas installed
- Remove:
skills-atlas remove "<skill>" --project --yes (drop --project for the global copy)
Grow (self-evolving)
- If the user keeps doing a multi-step procedure no skill covers, run
skills-atlas craft — it drafts a SKILL.md from THEIR own repeated workflow for them to review (a
draft, written to ./.claude/skills/, never auto-active).
- Recommend catalog skills for the kinds of work they keep doing:
skills-atlas gaps
- Suggest installed skills they no longer use:
skills-atlas prune
The autopilot (on by default with this plugin)
This plugin ships a UserPromptSubmit hook that quietly suggests a catalog skill when the
user's prompt lines up with one they don't have, surfaces recurring capability gaps, and
offers to craft a skill for a repeated workflow — each judged for genuine fit before
anything surfaces. It's on by default; skills-atlas hook off disables it and
skills-atlas hook status shows the controls. Nothing leaves the machine.
How to help
- Turn the user's need into a short search query (plus filters), run
search, and
present the top matches from the JSON — what each does and its exact use command.
- Install with
skills-atlas use <skill> --yes --project. Multi-source skills auto-pick
the best installable one; pass --source <id> to choose.
use installs AND prints the SKILL.md to apply immediately; a plain install just
saves it for the project's next session.
Requires the skills-atlas-cli package on PATH (npm i -g skills-atlas-cli, or
npm link in the package directory for local development).
