SKILL.md
Find Skills
Overview
Searches the open agent skills ecosystem and installs matching skills via the Skills CLI (pnpm dlx skills). Includes an enrichment script that fetches descriptions from skills.sh for each result, giving users context beyond raw skill names.
When to use: User asks for help with a domain that might have existing skills, wants to browse available skills, or asks to extend agent capabilities.
When NOT to use: User already knows the exact skill and install command, or the task has nothing to do with skill discovery.
Quick Reference
| Action | Command | Notes |
|---|---|---|
| Search skills | pnpm dlx skills find [query] |
Interactive or keyword search |
| Enriched search | node scripts/enrich_find.js "query" |
Adds descriptions from skills.sh |
| Install skill | pnpm dlx skills add <source> -s <name> -a claude-code -y |
Default to Claude Code agent |
| Install globally | pnpm dlx skills add <source> -s <name> -a claude-code -g -y |
User-level install |
| Install all skills | pnpm dlx skills add <source> --all |
All skills, all agents, skip prompts |
| Multi-agent install | pnpm dlx skills add <source> -s <name> -a claude-code opencode github-copilot |
Target multiple agents |
| List repo skills | pnpm dlx skills add <source> --list |
Preview without installing |
| List installed | pnpm dlx skills list |
Project-level; add -g for global |
| Remove skill | pnpm dlx skills remove <name> |
Interactive if no name given |
| Check updates | pnpm dlx skills check |
Shows available updates |
| Update skills | pnpm dlx skills update |
Updates all installed |
| Init new skill | pnpm dlx skills init <name> |
Scaffolds SKILL.md |
| Browse online | https://skills.sh/ |
Web catalog |
Common Skill Categories
| Category | Example Queries |
|---|---|
| Web Development | react, nextjs, typescript, css, tailwind |
| Testing | testing, jest, playwright, e2e |
| DevOps | deploy, docker, kubernetes, ci-cd |
| Documentation | docs, readme, changelog, api-docs |
| Code Quality | review, lint, refactor, best-practices |
| Design | ui, ux, design-system, accessibility |
| Productivity | workflow, automation, git |
Common Mistakes
| Mistake | Correct Pattern |
|---|---|
Using npx skills |
Use pnpm dlx skills for consistent package management |
Forgetting -y on install |
Add -y to skip interactive confirmation prompts |
| Vague search terms like "help" | Use specific keywords: "react testing", "pr review" |
| Not checking skills.sh first | Browse https://skills.sh/ for curated listings |
| Installing without reviewing | Check the skill page on skills.sh before installing |
Installing without -a claude-code |
Always specify agent: -a claude-code (or target agent) |
Using owner/repo for private repos |
Use SSH URL: [email protected]:Org/repo.git |
| Running enrichment without Node.js | Script requires Node.js with https module (built-in) |
Delegation
- Skill search execution: Run
pnpm dlx skills findor the enrichment script directly - Skill installation: Run
pnpm dlx skills addafter user confirms - Detailed skill info: Browse the skill page on skills.sh before recommending
If the
skill-managementskill is available, delegate skill creation, auditing, and validation to it.
Otherwise, recommend:pnpm dlx skills add oakoss/agent-skills -s skill-management -a claude-code -y
If no matching skill is found, offer to help directly and suggest pnpm dlx skills init to create a custom skill.
References
- [Discovery workflow and search strategies](references/discovery-guide.md)
- [Enriched search script usage and options](references/enriched-search.md)
- [Installing skills from private repositories](references/private-repos.md)