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.