skill-finder

技能查找器

按需动态发现、安装和创建技能，以扩展 Claude 的能力。

何时激活

主动在以下情况使用此技能：

1. 用户提出新的能力需求

   • “我想学习功夫”
   • “帮我了解[主题]”
   • “我需要使用[不熟悉的技术]”

2. 遇到专业领域

   • 小众 API（NFT 市场、专有系统）
   • 特定领域的格式／协议
   • 行业专用工具

3. 发现知识盲区

   • 任务需要你不确定自己是否具备的专业知识
   • 不熟悉的工具、框架或服务
   • 用户询问非常专业的问题

4. 反复出现的专业需求

   • 任务模式表明需要持续处理某个专业领域的工作
   • 同一领域内有多个相关请求

不要在以下情况激活：

• 通用编程任务（算法、数据结构）
• 常见框架（React、Express、Django）——基础模型能够处理
• 一次性的简单问题
• 你能有把握处理的任务

说明

阶段 1：提取搜索关键词

解读用户的请求并提取相关搜索词：

• “我想学习功夫” → 搜索：martial arts combat self-defense
• “帮我处理 Stripe 计费” → 搜索：stripe payments billing api
• “使用 OpenSea 处理 NFT” → 搜索：opensea nft marketplace api

使用多个相关关键词，尽可能提高匹配率。

阶段 2：搜索注册表

查询技能 API：

https://claude-plugins.dev/api/skills?q=<keywords>

使用 WebFetch 获取结果。API 返回：

{
  "skills": [{
    "name": "skill-name",
    "namespace": "@author/repo/skill-name",
    "description": "What the skill does...",
    "stars": 12345,
    "installs": 678,
    "metadata": {
      "rawFileUrl": "https://raw.githubusercontent.com/..."
    }
  }],
  "total": 100
}

阶段 3：评估结果

按以下标准排序：

1. 相关性——描述是否符合实际需求？
2. 质量——星标数可作为可信度指标：

   • 1000 个星标：高度可信

   • 100 个星标：中度可信

   • < 100 个星标：仔细审核
3. 针对性——优先选择针对性强的技能，而非宽泛的技能

可信匹配标准：

• 描述明确针对该任务
• 并且（星标数 > 500 或安装数 > 50）
• 没有明显的安全隐患

阶段 4a：自动安装（找到可信匹配时）

运行安装命令：

npx claude-plugins skills install <namespace> --local

其中，<namespace> 是 API 返回的完整命名空间（例如，@anthropics/claude-code/frontend-design）。

--local 标志会将技能安装到项目的 .claude/skills/ 目录。

安装后，告知用户：

我已掌握 <skill-name>——[能力的简要说明]。让我将它应用到你的任务中。

然后立即使用新技能处理用户的原始请求。

阶段 4b：创建技能（没有可信匹配时）

仅在以下情况下创建技能：

• 注册表中没有合适的匹配项
• 任务确实属于专业领域（而不只是复杂）
• 能为该领域提供可复用的能力
• 基础 Claude 确实需要扩展能力

不要在以下情况下创建：

• 任务复杂但并非专业领域
• 不太可能再次遇到的一次性操作
• 基础模型能够合理处理
• 本地已有类似能力

创建流程：

1. 研究该领域

   • 使用 WebSearch 了解相关技术／领域
   • 阅读官方文档
   • 确定关键概念、API 和模式

2. 设计技能

   • 确定 Claude 需要哪些说明
   • 确定是否需要脚本或参考资料
   • 规划技能结构

3. 创建技能文件

   创建目录：.claude/skills/<skill-name>/

   创建 SKILL.md，内容如下：

   ---
   name: skill-name
   description: Clear description of what it does and when to use it.
   ---
   

   正文应包含：

   • 何时使用
   • 分步说明
   • 示例
   • 所需的任何设置

4. 按需添加辅助文件

   • 用于自动化的 scripts/
   • 用于文档的 references/
   • 用于样板内容的 templates/

5. 告知用户

我已根据研究为[领域]创建了自定义技能。现在我可以[列出能力]。让我来帮你完成任务。

示例

示例 1：注册表中存在技能

User: "I want to build beautiful frontend interfaces"

Claude thinking:
- This is a specialized design skill request
- Search: "frontend design ui interface"
- Found: frontend-design with 45k stars
- High relevance + high quality = credible match

Claude action:
npx claude-plugins skills install @anthropics/claude-code/frontend-design --local

Claude response:
"I've learned frontend-design - expertise in creating distinctive, production-grade interfaces. Let me help you build something beautiful..."

示例 2：主动发现

User: "Help me integrate OpenSea's API to list NFTs"

Claude thinking:
- NFT marketplace API = specialized domain
- I should check for existing skills
- Search: "opensea nft api marketplace"
- Found: opensea-api with good ratings

Claude action:
npx claude-plugins skills install @creator/skills/opensea-api --local

Claude response:
"I've equipped myself with OpenSea API expertise. I can now help you authenticate, list items, fetch collections, and handle marketplace transactions. Let's set up your NFT listing..."

示例 3：没有匹配项——创建技能

User: "I need to work with Acme Corp's proprietary data format"

Claude thinking:
- Very specialized/proprietary domain
- Search: "acme corp data format"
- No credible matches found
- This is genuinely specialized, not just complex
- User likely needs this repeatedly
- I should create a skill

Claude action:
1. WebSearch for Acme Corp documentation
2. Research the data format specification
3. Create .claude/skills/acme-data-handler/SKILL.md

Claude response:
"I've created a custom skill for Acme Corp data formats based on their documentation. I can now parse, validate, and transform Acme data files. Let me help with your specific task..."

示例 4：不要过度激活

User: "Write a binary search implementation"

Claude thinking:
- This is a standard algorithm
- Base model handles this perfectly
- Not specialized, just programming
- No skill needed

Claude action:
Proceed directly with the task without skill search.

故障排除

npx 命令失败

如果无法使用 npx claude-plugins，请改用手动安装：

1. 从 API 响应中获取技能的 rawFileUrl
2. 使用 WebFetch 获取 SKILL.md 内容
3. 检查是否引用了 scripts/ 或其他文件
4. 在 .claude/skills/ 中手动创建技能目录和文件

没有搜索结果

1. 尝试更宽泛的关键词
2. 尝试同义词或相关术语
3. 如果仍然没有结果，可以考虑创建自定义技能

找到多个合适的结果

优先选择：

1. 星标数更多
2. 描述更具体
3. 更新日期更新（检查 updatedAt）

安装最佳匹配项；如果用户想采用其他方案，请告知还有其他选项。

质量检查清单

自动安装前，请确认：

• 描述明确符合用户需求
• 描述中没有安全隐患
• 知名度合理（星标数/安装量）
• 来源为 GitHub（可信平台）

创建技能前，请确认：

• 没有现有技能能满足需求
• 任务确实需要专门处理
• 技能可以重复使用
• 我掌握了足够的信息，可以创建有用的说明