About find-skills
A skill for discovering and installing agent skills through the Skills CLI. It can enrich search results with descriptions from skills.sh and covers listing, updating, removing, and initializing skills for agent setups.
Key features
- 01Search the agent skills catalog
- 02Enrich results with skills.sh descriptions
- 03Install skills for selected agents
- 04List, update, and remove skills
- 05Initialize a new skill
Use cases
- 01Find skills for a domain-specific task
- 02Compare search results using descriptions
- 03Install a skill for one or more agents
- 04Check or update installed skills
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ oakoss/ agent-skills --skill find-skillsAfter installing, type/find-skillsin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/discovery-guide.mdenriched-search.mdprivate-repos.mdscripts/enrich_find.jsDetails
From the project READMEFind 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.