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: git@github.com: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 find or the enrichment script directly
- Skill installation: Run
pnpm dlx skills add after user confirms
- Detailed skill info: Browse the skill page on skills.sh before recommending
If the skill-management skill 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
- Enriched search script usage and options
- Installing skills from private repositories
1---2name: find-skills3description: Discovers and installs agent skills from the open ecosystem. Enriches search results with descriptions fetched from skills.sh. Use when a user asks "how do I do X", "find a skill for X", "is there a skill that can...", or wants to extend agent capabilities. Use for skill discovery, skill search, skill install, finding tools.4license: MIT5---6
7# Find Skills
8
9## Overview
10
11Searches 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.
12
13**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.
14
15**When NOT to use:** User already knows the exact skill and install command, or the task has nothing to do with skill discovery.
16
17## Quick Reference
18
19| Action | Command | Notes |
20| ------------------- | ------------------------------------------------------------------------------- | ------------------------------------ |
21| Search skills | `pnpm dlx skills find [query]` | Interactive or keyword search |
22| Enriched search | `node scripts/enrich_find.js "query"` | Adds descriptions from skills.sh |
23| Install skill | `pnpm dlx skills add <source> -s <name> -a claude-code -y` | Default to Claude Code agent |
24| Install globally | `pnpm dlx skills add <source> -s <name> -a claude-code -g -y` | User-level install |
25| Install all skills | `pnpm dlx skills add <source> --all` | All skills, all agents, skip prompts |
26| Multi-agent install | `pnpm dlx skills add <source> -s <name> -a claude-code opencode github-copilot` | Target multiple agents |
27| List repo skills | `pnpm dlx skills add <source> --list` | Preview without installing |
28| List installed | `pnpm dlx skills list` | Project-level; add `-g` for global |
29| Remove skill | `pnpm dlx skills remove <name>` | Interactive if no name given |
30| Check updates | `pnpm dlx skills check` | Shows available updates |
31| Update skills | `pnpm dlx skills update` | Updates all installed |
32| Init new skill | `pnpm dlx skills init <name>` | Scaffolds SKILL.md |
33| Browse online | `https://skills.sh/` | Web catalog |
34
35## Common Skill Categories
36
37| Category | Example Queries |
38| --------------- | ---------------------------------------- |
39| Web Development | react, nextjs, typescript, css, tailwind |
40| Testing | testing, jest, playwright, e2e |
41| DevOps | deploy, docker, kubernetes, ci-cd |
42| Documentation | docs, readme, changelog, api-docs |
43| Code Quality | review, lint, refactor, best-practices |
44| Design | ui, ux, design-system, accessibility |
45| Productivity | workflow, automation, git |
46
47## Common Mistakes
48
49| Mistake | Correct Pattern |
50| ------------------------------------ | -------------------------------------------------------- |
51| Using `npx skills` | Use `pnpm dlx skills` for consistent package management |
52| Forgetting `-y` on install | Add `-y` to skip interactive confirmation prompts |
53| Vague search terms like "help" | Use specific keywords: "react testing", "pr review" |
54| Not checking skills.sh first | Browse `https://skills.sh/` for curated listings |
55| Installing without reviewing | Check the skill page on skills.sh before installing |
56| Installing without `-a claude-code` | Always specify agent: `-a claude-code` (or target agent) |
57| Using `owner/repo` for private repos | Use SSH URL: `git@github.com:Org/repo.git` |
58| Running enrichment without Node.js | Script requires Node.js with `https` module (built-in) |
59
60## Delegation
61
62- **Skill search execution**: Run `pnpm dlx skills find` or the enrichment script directly
63- **Skill installation**: Run `pnpm dlx skills add` after user confirms
64- **Detailed skill info**: Browse the skill page on skills.sh before recommending
65
66> If the `skill-management` skill is available, delegate skill creation, auditing, and validation to it.
67> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s skill-management -a claude-code -y`
68
69If no matching skill is found, offer to help directly and suggest `pnpm dlx skills init` to create a custom skill.
70
71## References
72
73- [Discovery workflow and search strategies](references/discovery-guide.md)
74- [Enriched search script usage and options](references/enriched-search.md)
75- [Installing skills from private repositories](references/private-repos.md)
oakoss