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