use-findskill

使用 Findskill

一个元技能，教 AI Agent 如何在 findskill.md 生态系统中发现、安装和使用技能。

描述

此技能可帮助你通过 findskill.md 注册表查找并安装专用技能，从而扩展自身能力。当用户要求你执行某项任务，而你没有相应技能时，或者你需要专门功能时，请使用 findskill 来发现并安装相关技能。

何时使用 Findskill

在以下情况下使用 findskill：

• 用户要求你执行一项能从专用技能中受益的任务
• 你需要特定领域的知识或工作流（git 提交、代码审查、文档等）
• 用户明确要求你查找或安装技能
• 你想确认是否有更好的方式来完成常见任务

运行 Findskill

你有两种方式运行 findskill 命令：

选项 1：使用 npx（无需安装）

直接运行命令，无需安装：

npx findskill <command>

选项 2：全局安装

安装一次，之后运行时无需加 npx 前缀：

npm install -g findskill
findskill <command>

可用命令

以下示例均使用 npx findskill。如果已全局安装，请省略 npx 前缀。

搜索技能

按名称、描述或标签查找技能：

npx findskill search <query>

示例：

npx findskill search "git commit"
npx findskill search "documentation"
npx findskill search "review"

获取技能信息

安装前查看特定技能的详细信息：

npx findskill info <skill-name>

其中会显示作者、描述、标签、星标数和安装说明。

安装技能

安装技能以供使用：

npx findskill install <skill-name>

默认情况下，技能会安装到 ~/.claude/skills/。每个技能都包含一个 SKILL.md 文件，其中的说明应仔细阅读并遵循。

列出已安装的技能

查看已有的可用技能：

npx findskill list

更新技能

将已安装的技能更新至最新版本：

npx findskill update           # Update all skills
npx findskill update <name>    # Update specific skill

Agent 工作流

1. 评估任务：判断专用技能是否有助于更有效地实现用户目标。

2. 搜索相关技能：

   npx findskill search "<relevant keywords>"
   

3. 查看技能详情：安装前，先检查该技能的功能：

   npx findskill info <skill-name>
   

4. 酌情安装：如果该技能符合用户需求：

   npx findskill install <skill-name>
   

5. 阅读已安装的技能：安装后，阅读 SKILL.md 以了解如何使用该技能：

   cat ~/.claude/skills/<skill-name>/SKILL.md
   

6. 应用技能：按照技能 SKILL.md 中的说明完成用户任务。

最佳实践

• 先检查已安装的技能：搜索前运行 npx findskill list，查看当前已有的技能。
• 使用前先阅读：安装后务必阅读技能的 SKILL.md，了解其功能和正确用法。
• 让技能匹配任务：不要无故安装技能。只有在当前任务确实能从中受益时才安装。
• 告知用户：安装新技能时，告诉用户安装原因，以及它如何帮助完成请求。

交互示例

用户：“帮我为这些更改写一条好的 git 提交消息”

Agent 思考过程：

1. 这是一项常见任务，可能有专用技能
2. 搜索相关技能：npx findskill search "commit"
3. 找到“commit”技能——查看详情：npx findskill info commit
4. 安装该技能：npx findskill install commit
5. 阅读技能说明：cat ~/.claude/skills/commit/SKILL.md
6. 遵循该技能的工作流，帮助用户撰写恰当的提交消息

环境变量

• FINDSKILL_DIR：自定义安装目录（默认：~/.claude/skills/）
• FINDSKILL_API：自定义 API 端点（用于可自托管的注册表）

标签

技能、元技能、findskill、发现、安装、包管理器、claude-skills