mcpField
S
skills-discovery

skills-discovery

github.com/kamalnrfAgent 工作流56397 次安装18 周前更新
代码仓库

关于 skills-discovery

介绍如何通过 claude-plugins.dev 注册表查找和管理 Agent Skills，涵盖搜索时机、API 查询、按客户端安装及技能管理。

主要功能

  1. 01通过注册表 API 搜索技能
  2. 02使用查询词和分页参数
  3. 03为支持的客户端及范围安装
  4. 04列出或卸载已安装技能
  5. 05整理相关结果并征求确认

适用场景

  1. 01查找适用于某项技术或任务的技能
  2. 02开始专业任务前搜索技能
  3. 03为指定客户端安装技能
  4. 04查看或移除已安装技能

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/kamalnrf/claude-plugins --skill skills-discovery

安装后在 Claude Code 中输入/skills-discovery确认已加载。

详细介绍

技能发现

你可以通过发现并安装 claude-plugins.dev 注册表中的 Agent 技能来扩展能力。技能针对特定技术、框架和领域提供专业知识、工具和技巧。

何时搜索技能

首先，检查已安装的技能中是否有适用于当前任务的技能。如果没有，请搜索注册表——你可能尚未安装适用的专业技能。

开始任何非简单任务之前，请先自问：

  1. 我有适用的技能吗？→ 使用它
  2. 是否可能存在我尚未安装的技能？→ 搜索注册表

在以下情况下主动搜索：

  • 任务涉及特定技术、框架或文件格式
  • 你即将开展需要遵循最佳实践的工作（测试、部署、API、文档）
  • 任务领域较为专业（PDF 处理、数据管道、ML 工作流）
  • 你发现自己即将给出泛泛的建议，而专家经验会有所帮助

用户明确要求查找、安装或管理技能时，也要进行搜索。

发现工作流

使用注册表 API 进行搜索（CLI 的搜索命令是交互式的，不适合以编程方式使用）：

curl "https://claude-plugins.dev/api/skills?q=QUERY&limit=20&offset=0"

参数：

  • q：搜索查询（例如 "frontend"、"python"、"pdf"）
  • limit：每页结果数（最多 100）
  • offset：分页偏移量

响应结构：

{
  "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
}

搜索策略

注册表会索引技能名称、描述和标签。构造查询时，应使用与技能作者描述其工作时相符的词语。

构造查询：

  • 使用 1-3 个具体词语（过于宽泛会产生噪声，过于狭窄则可能错过结果）
  • 优先使用广泛通用的术语，而非项目专用行话
  • 技术与任务组合查询往往比单独查询其中一项效果更好
  • 如果结果不理想，请扩大范围或尝试同义词

安装

安装前，先确定用户使用的是哪个客户端。如果不清楚，请询问。

支持的客户端：

  • 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
  • gemini - Gemini CLI
  • windsurf - Windsurf 编辑器
  • antigravity - Antigravity
  • trae - Trae
  • qoder - Qoder
  • codebuddy - CodeBuddy
  • 客户端选择：
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

范围选择：

npx skills-installer install @owner/repo/skill-name  # global (default)
npx skills-installer install @owner/repo/skill-name --local  # project-specific

组合使用：

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

默认值：

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

管理

# List installed skills
npx skills-installer list

# Uninstall a skill
npx skills-installer uninstall @owner/repo/skill-name

向用户展示结果

找到相关技能后：

  1. 最多展示 3-5 个最相关的结果
  2. 包含：名称、命名空间、描述、星标数、安装数
  3. 说明每项技能如何帮助完成用户的_具体_任务
  4. 优先推荐安装数较高的技能
  5. 安装前务必征求确认
  6. 如果没有合适的技能，或用户拒绝安装，请主动提出直接提供帮助

示例

示例：主动推荐

用户：“我需要创建一个 Django REST API”

curl "https://claude-plugins.dev/api/skills?q=django&limit=10"

展示推荐：

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?

示例：明确的搜索请求

用户：“查找 Python 技能”

curl "https://claude-plugins.dev/api/skills?q=python&limit=10"

展示结果并询问要安装哪些技能。

API 参考

端点描述
GET /api/skills/search?q=QUERY搜索技能
GET /api/skills/@owner/repo/skill-name获取技能详情

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

故障排除

未找到结果：

安装失败：

  • 确认命名空间格式：@owner/repo/skill-name
  • 检查注册表中是否存在该技能
  • 检查目录权限

技能未激活：

  • 用户可能需要重启客户端
  • 确认安装目录正确
  • 确认安装路径中存在 SKILL.md

评论

支持 Markdown