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注册表中发现并安装Agent Skills来扩展自身能力。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:

Do I have a skill for this? → Use it
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匹配当前任务。如果没有，请搜索注册表——可能存在你尚未安装的专属Skill。

在开始任何非琐碎任务前，请自问：

我是否有适用于此任务的Skill？→ 使用它
是否存在我未安装的相关Skill？→ 搜索注册表

在以下场景中主动搜索：

任务涉及特定技术、框架或文件格式
你即将开展的工作需要遵循最佳实践（如测试、部署、API、文档编写）
领域具有专业性（如PDF处理、数据管道、ML workflows）
你发现自己即将给出通用建议，但专业模式会更有帮助

当用户明确要求查找、安装或管理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
}

使用注册表API进行搜索（CLI的search命令为交互式，不适合程序化使用）：

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

注册表会为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
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编辑器
```
amp
```
- amp CLI
```
opencode
```
- OpenCode CLI
```
goose
```
- Goose CLI
```
github
```
— VSCode/ github
```
vscode
```
— VS Code
```
letta
```
— Letta CLI
客户端选择示例：

bash

npx skills-installer install @owner/repo/skill-name --client claude-code  # 默认
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  # 全局（默认）
npx skills-installer install @owner/repo/skill-name --local  # 项目专属

组合示例：

bash

npx skills-installer install @owner/repo/skill-name --client cursor --local

默认设置：

客户端：
```
claude-code
```
范围：全局

Management

管理

bash

undefined

bash

undefined

List installed skills

列出已安装的Skill

npx skills-installer list

Uninstall a skill

卸载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:

Show 3-5 most relevant results maximum
Include: name, namespace, description, stars, installs
Explain how each skill helps with their specific task
Prioritize those with high installs
Always ask for confirmation before installing
Offer to help directly if no good skill exists or user declines

当你找到相关Skill时：

最多展示3-5个最相关的结果
包含：名称、命名空间、描述、星标数、安装量
解释每个Skill如何帮助完成用户的特定任务
优先展示安装量高的Skill
安装前务必征得用户确认
如果没有合适的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参考

Endpoint	Description
`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详情

Web注册表： https://claude-plugins.dev/skills

Troubleshooting

故障排除

No results found:

Try broader search terms
Browse web registry: https://claude-plugins.dev/skills

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

未找到结果：

尝试更宽泛的搜索词
浏览Web注册表：https://claude-plugins.dev/skills

安装失败：

验证命名空间格式：
```
@owner/repo/skill-name
```
检查Skill是否存在于注册表中
验证目录权限

Skill未激活：

用户可能需要重启客户端
验证安装目录是否正确
确认安装路径中存在SKILL.md文件