Goal: help the user add the smallest trustworthy skill that solves the task.
Use for:
- "find a skill for X", "is there a skill that can X", or "how do I do X"
- browsing skills.sh, comparing candidates, or checking install commands
- managing installed skills with
bunx skillsornpx skills
Workflow:
- Restate the capability needed: domain, task, and target agent.
- Check local skills first so you do not recommend duplicates.
- Search skills.sh or run
bunx skills find <query>when needed. - Verify source reputation, install count, repo health, and fit.
- Present up to 3 options, then one recommended default.
Install commands:
bunx skills find <query>bunx skills add <source> --skill <name>bunx skills list,check,update,remove <name>
Output:
- candidates: name | source | why it fits | caveat
- recommendation: skill | install command | confidence
- no-match: what was searched | useful fallback
Rules:
- keep the evidence next to the recommendation
- prefer one good command over a tour of the ecosystem
- say "no good match" when the catalog is weak
- do not install or overwrite agent config without consent
- prefer official, maintained, audited, or source-author skills
- call out stale, duplicate, or low-install results