Back to Details

skills-discovery

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skills Discovery

Skill 发现

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.
你可以通过从claude-plugins.dev registry发现并安装Agent Skill来扩展你的能力。Skill可为特定技术、框架和领域提供专业知识、工具和技术。

When to search for skills

什么时候搜索Skill

First, check if an installed skill matches the task. If not, search the registry—specialized skills may exist that you haven't installed yet.
Before starting any non-trivial task, ask yourself:
  1. Do I have a skill for this? → Use it
  2. Might one exist that I don't have? → Search the registry
Search proactively when:
  • The task involves specific technologies, frameworks, or file formats
  • You're about to do something where best practices matter (testing, deployment, APIs, documentation)
  • The domain is specialized (PDF processing, data pipelines, ML workflows)
  • You notice yourself about to give generic advice where expert patterns would help
Also search when users explicitly ask to find, install, or manage skills.
首先检查已安装的Skill是否匹配当前任务。如果不匹配，搜索registry——可能存在你尚未安装的专用Skill。
在开始任何非简单任务前，先问自己：
  1. 我有对应这项任务的Skill吗？→ 使用它
  2. 是否存在我还未安装的相关Skill？→ 搜索registry
当出现以下情况时主动搜索：
  • 任务涉及特定技术、框架或文件格式
  • 你即将开展的工作需要遵循最佳实践（测试、部署、API、文档）
  • 属于专业领域（PDF处理、数据管道、ML工作流）
  • 你发现自己即将给出通用建议，而专家模式能提供更好的帮助
当用户明确要求查找、安装或管理Skill时也需要搜索。

Discovery workflow

发现工作流

Use the registry API for search (the CLI's search command is interactive and not suitable for programmatic use):
bash
curl "https://claude-plugins.dev/api/skills?q=QUERY&limit=20&offset=0"
Parameters:
  • q
    : Search query (e.g., "frontend", "python", "pdf")
  • limit
    : Results per page (max 100)
  • offset
    : Pagination offset
Response structure:
json
{
  "skills": [
    {
      "id": "...",
      "name": "skill-name",
      "namespace": "@owner/repo/skill-name",
      "sourceUrl": "https://github.com/...",
      "description": "...",
      "author": "...",
      "installs": 123,
      "stars": 45
    }
  ],
  "total": 100,
  "limit": 10,
  "offset": 0
}
使用registry API进行搜索（CLI的搜索命令是交互式的，不适合程序化使用）：
bash
curl "https://claude-plugins.dev/api/skills?q=QUERY&limit=20&offset=0"
参数：
  • q
    : 搜索查询（例如 "frontend", "python", "pdf"）
  • limit
    : 每页结果数（最大100）
  • offset
    : 分页偏移量
响应结构：
json
{
  "skills": [
    {
      "id": "...",
      "name": "skill-name",
      "namespace": "@owner/repo/skill-name",
      "sourceUrl": "https://github.com/...",
      "description": "...",
      "author": "...",
      "installs": 123,
      "stars": 45
    }
  ],
  "total": 100,
  "limit": 10,
  "offset": 0
}

Search strategies

搜索策略

The registry indexes skill names, descriptions, and tags. Construct queries that match how skill authors describe their work.
Query construction:
  • Use 1-3 specific terms (too broad = noise, too narrow = misses)
  • Prefer widely-used terminology over project-specific jargon
  • Technology + task often outperforms either alone
  • If results are poor, broaden or try synonyms
registry会对Skill名称、描述和标签建立索引。构建的查询要匹配Skill作者描述其作品的方式。
查询构建：
  • 使用1-3个特定术语（太宽泛=噪声太多，太狭窄=漏结果）
  • 优先使用广泛采用的术语，而非项目专属黑话
  • 技术+任务的组合通常比单独使用任一效果更好
  • 如果搜索结果不佳，放宽范围或尝试同义词

Installation

安装

Determine which client the user is working in before installing. If unclear, ask.
Supported clients:
  • claude-code
    — Claude Code CLI
  • codex
    — Codex
  • cursor
    — Cursor editor
  • amp
    - amp CLI
  • opencode
    - OpenCode CLI
  • goose
    - Goose CLI
  • github
    — VSCode/ github
  • vscode
    — VS Code
  • letta
    — Letta CLI
  • gemini
    - Gemini CLI
  • windsurf
    - Windsurf editor
  • antigravity
    - Antigravity
  • trae
    - Trae
  • qoder
    - Qoder
  • codebuddy
    - CodeBuddy
  • Client selection:
bash
npx skills-installer install @owner/repo/skill-name --client claude-code  # default
npx skills-installer install @owner/repo/skill-name --client cursor
npx skills-installer install @owner/repo/skill-name --client vscode
Scope selection:
bash
npx skills-installer install @owner/repo/skill-name  # global (default)
npx skills-installer install @owner/repo/skill-name --local  # project-specific
Combined:
bash
npx skills-installer install @owner/repo/skill-name --client cursor --local
Defaults:
  • Client: 
    claude-code
  • Scope: global
安装前先确定用户使用的客户端。如果不清楚，直接询问用户。
支持的客户端：
  • claude-code
    — Claude Code CLI
  • codex
    — Codex
  • cursor
    — Cursor editor
  • amp
    - amp CLI
  • opencode
    - OpenCode CLI
  • goose
    - Goose CLI
  • github
    — VSCode/ github
  • vscode
    — VS Code
  • letta
    — Letta CLI
  • gemini
    - Gemini CLI
  • windsurf
    - Windsurf editor
  • antigravity
    - Antigravity
  • trae
    - Trae
  • qoder
    - Qoder
  • codebuddy
    - CodeBuddy
客户端选择：
bash
npx skills-installer install @owner/repo/skill-name --client claude-code  # default
npx skills-installer install @owner/repo/skill-name --client cursor
npx skills-installer install @owner/repo/skill-name --client vscode
作用域选择：
bash
npx skills-installer install @owner/repo/skill-name  # global (default)
npx skills-installer install @owner/repo/skill-name --local  # project-specific
组合使用：
bash
npx skills-installer install @owner/repo/skill-name --client cursor --local
默认配置：
  • 客户端：
    claude-code
  • 作用域：全局

Management

管理

bash
undefined
bash
undefined

List installed skills

List installed skills

npx skills-installer list
npx skills-installer list

Uninstall a skill

Uninstall a skill

npx skills-installer uninstall @owner/repo/skill-name
undefined
npx skills-installer uninstall @owner/repo/skill-name
undefined

Presenting results to users

向用户展示结果

When you find relevant skills:
  1. Show 3-5 most relevant results maximum
  2. Include: name, namespace, description, stars, installs
  3. Explain how each skill helps with their specific task
  4. Prioritize those with high installs
  5. Always ask for confirmation before installing
  6. Offer to help directly if no good skill exists or user declines
当你找到相关Skill时：
  1. 最多展示3-5个最相关的结果
  2. 包含：名称、命名空间、描述、星标数、安装量
  3. 解释每个Skill如何帮助用户完成特定任务
  4. 优先展示安装量高的Skill
  5. 安装前务必征得用户确认
  6. 如果没有合适的Skill或用户拒绝安装，主动提出直接提供帮助

Examples

示例

Example: Proactive suggestion
User: "I need to create a Django REST API"
bash
curl "https://claude-plugins.dev/api/skills?q=django&limit=10"
Present suggestion:
I found some skills that could help:

1. django-rest-framework-expert (@anthropics/claude-code/django-rest-framework-expert)
   Description: Django REST API development with best practices
   ⭐ 234 stars • 1,567 installs

Would you like me to install this, or help you directly without installing a skill?
Example: Explicit search request
User: "find skills for Python"
bash
curl "https://claude-plugins.dev/api/skills?q=python&limit=10"
Present results and ask which to install.
示例：主动建议
用户："我需要创建一个Django REST API"
bash
curl "https://claude-plugins.dev/api/skills?q=django&limit=10"
展示建议：
我找到了一些可以提供帮助的Skill：

1. django-rest-framework-expert (@anthropics/claude-code/django-rest-framework-expert)
   描述：遵循最佳实践的Django REST API开发
   ⭐ 234 星标 • 1,567 次安装

你是否希望我安装这个Skill，或者不安装Skill直接帮你完成？
示例：明确搜索请求
用户："查找适用于Python的Skill"
bash
curl "https://claude-plugins.dev/api/skills?q=python&limit=10"
展示结果并询问要安装哪一个。

API reference

API参考

EndpointDescription
GET /api/skills/search?q=QUERY
Search skills
GET /api/skills/@owner/repo/skill-name
Get skill details
Web registry: https://claude-plugins.dev/skills
端点描述
GET /api/skills/search?q=QUERY
搜索Skill
GET /api/skills/@owner/repo/skill-name
获取Skill详情
网页版registry： https://claude-plugins.dev/skills

Troubleshooting

问题排查

No results found:
Installation fails:
  • Verify namespace format: 
    @owner/repo/skill-name
  • Check skill exists in registry
  • Verify directory permissions
Skill not activating:
  • User may need to restart their client
  • Verify correct installation directory
  • Confirm SKILL.md exists in installation path
未找到结果：
安装失败：
  • 确认命名空间格式：
    @owner/repo/skill-name
  • 检查Skill是否存在于registry中
  • 确认目录权限
Skill未激活：
  • 用户可能需要重启客户端
  • 确认安装目录正确
  • 确认安装路径下存在SKILL.md文件