skill-finder

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

1. 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.
2. Install with skills-atlas use <skill> --yes --project. Multi-source skills auto-pick the best installable one; pass --source <id> to choose.
3. 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).