$npx -y skills add Kamalnrf/claude-plugins --skill skills-discoverySearch for and install Agent Skills that give you specialized capabilities. Before starting work, ask might a skill exist that handles this better than my base knowledge? If the task involves specific technologies, frameworks, file formats, or expert domains. Search proactively,
| 1 | # Skills Discovery |
| 2 | |
| 3 | You can extend your capabilities by discovering and installing Agent Skills from the claude-plugins.dev registry. Skills provide specialized knowledge, tools, and techniques for specific technologies, frameworks, and domains. |
| 4 | |
| 5 | ## When to search for skills |
| 6 | |
| 7 | First, check if an installed skill matches the task. If not, search the registry—specialized skills may exist that you haven't installed yet. |
| 8 | |
| 9 | Before starting any non-trivial task, ask yourself: |
| 10 | |
| 11 | 1. Do I have a skill for this? → Use it |
| 12 | 2. Might one exist that I don't have? → Search the registry |
| 13 | |
| 14 | Search proactively when: |
| 15 | |
| 16 | - The task involves specific technologies, frameworks, or file formats |
| 17 | - You're about to do something where best practices matter (testing, deployment, APIs, documentation) |
| 18 | - The domain is specialized (PDF processing, data pipelines, ML workflows) |
| 19 | - You notice yourself about to give generic advice where expert patterns would help |
| 20 | |
| 21 | Also search when users explicitly ask to find, install, or manage skills. |
| 22 | |
| 23 | ## Discovery workflow |
| 24 | |
| 25 | Use the registry API for search (the CLI's search command is interactive and not suitable for programmatic use): |
| 26 | |
| 27 | ```bash |
| 28 | curl "https://claude-plugins.dev/api/skills?q=QUERY&limit=20&offset=0" |
| 29 | ``` |
| 30 | |
| 31 | **Parameters:** |
| 32 | |
| 33 | - `q`: Search query (e.g., "frontend", "python", "pdf") |
| 34 | - `limit`: Results per page (max 100) |
| 35 | - `offset`: Pagination offset |
| 36 | |
| 37 | **Response structure:** |
| 38 | |
| 39 | ```json |
| 40 | { |
| 41 | "skills": [ |
| 42 | { |
| 43 | "id": "...", |
| 44 | "name": "skill-name", |
| 45 | "namespace": "@owner/repo/skill-name", |
| 46 | "sourceUrl": "https://github.com/...", |
| 47 | "description": "...", |
| 48 | "author": "...", |
| 49 | "installs": 123, |
| 50 | "stars": 45 |
| 51 | } |
| 52 | ], |
| 53 | "total": 100, |
| 54 | "limit": 10, |
| 55 | "offset": 0 |
| 56 | } |
| 57 | ``` |
| 58 | |
| 59 | ## Search strategies |
| 60 | |
| 61 | The registry indexes skill names, descriptions, and tags. Construct queries that match how skill authors describe their work. |
| 62 | |
| 63 | **Query construction:** |
| 64 | |
| 65 | - Use 1-3 specific terms (too broad = noise, too narrow = misses) |
| 66 | - Prefer widely-used terminology over project-specific jargon |
| 67 | - Technology + task often outperforms either alone |
| 68 | - If results are poor, broaden or try synonyms |
| 69 | |
| 70 | ## Installation |
| 71 | |
| 72 | Determine which client the user is working in before installing. If unclear, ask. |
| 73 | |
| 74 | **Supported clients:** |
| 75 | |
| 76 | - `claude-code` — Claude Code CLI |
| 77 | - `codex` — Codex |
| 78 | - `cursor` — Cursor editor |
| 79 | - `amp` - amp CLI |
| 80 | - `opencode` - OpenCode CLI |
| 81 | - `goose` - Goose CLI |
| 82 | - `github` — VSCode/ github |
| 83 | - `vscode` — VS Code |
| 84 | - `letta` — Letta CLI |
| 85 | - `gemini` - Gemini CLI |
| 86 | - `windsurf` - Windsurf editor |
| 87 | - `antigravity` - Antigravity |
| 88 | - `trae` - Trae |
| 89 | - `qoder` - Qoder |
| 90 | - `codebuddy` - CodeBuddy |
| 91 | - **Client selection:** |
| 92 | |
| 93 | ```bash |
| 94 | npx skills-installer install @owner/repo/skill-name --client claude-code # default |
| 95 | npx skills-installer install @owner/repo/skill-name --client cursor |
| 96 | npx skills-installer install @owner/repo/skill-name --client vscode |
| 97 | ``` |
| 98 | |
| 99 | **Scope selection:** |
| 100 | |
| 101 | ```bash |
| 102 | npx skills-installer install @owner/repo/skill-name # global (default) |
| 103 | npx skills-installer install @owner/repo/skill-name --local # project-specific |
| 104 | ``` |
| 105 | |
| 106 | **Combined:** |
| 107 | |
| 108 | ```bash |
| 109 | npx skills-installer install @owner/repo/skill-name --client cursor --local |
| 110 | ``` |
| 111 | |
| 112 | **Defaults:** |
| 113 | |
| 114 | - Client: `claude-code` |
| 115 | - Scope: global |
| 116 | |
| 117 | ## Management |
| 118 | |
| 119 | ```bash |
| 120 | # List installed skills |
| 121 | npx skills-installer list |
| 122 | |
| 123 | # Uninstall a skill |
| 124 | npx skills-installer uninstall @owner/repo/skill-name |
| 125 | ``` |
| 126 | |
| 127 | ## Presenting results to users |
| 128 | |
| 129 | When you find relevant skills: |
| 130 | |
| 131 | 1. Show 3-5 most relevant results maximum |
| 132 | 2. Include: name, namespace, description, stars, installs |
| 133 | 3. Explain how each skill helps with their _specific_ task |
| 134 | 4. Prioritize those with high installs |
| 135 | 5. Always ask for confirmation before installing |
| 136 | 6. Offer to help directly if no good skill exists or user declines |
| 137 | |
| 138 | ## Examples |
| 139 | |
| 140 | **Example: Proactive suggestion** |
| 141 | |
| 142 | User: "I need to create a Django REST API" |
| 143 | |
| 144 | ```bash |
| 145 | curl "https://claude-plugins.dev/api/skills?q=django&limit=10" |
| 146 | ``` |
| 147 | |
| 148 | Present suggestion: |
| 149 | |
| 150 | ``` |
| 151 | I found some skills that could help: |
| 152 | |
| 153 | 1. django-rest-framework-expert (@anthropics/claude-code/django-rest-framework-expert) |
| 154 | Description: Django REST API development with best practices |
| 155 | ⭐ 234 stars • 1,567 installs |
| 156 | |
| 157 | Would you like me to install this, or help you directly without installing a skill? |
| 158 | ``` |
| 159 | |
| 160 | **Example: Explicit search request** |
| 161 | |
| 162 | User: "find skills for Python" |
| 163 | |
| 164 | ```bash |
| 165 | curl "https://claude-plugins.dev/api/skills?q=python&limit=10" |
| 166 | ``` |
| 167 | |
| 168 | Present results and ask which to install. |
| 169 | |
| 170 | ## API reference |
| 171 | |
| 172 | | Endpoint |