skill-scout

Skill Scout

在创建新 Skill 之前先使用此 Skill。目标是避免重复造轮子（重复社区或插件市场已有的工作），同时在引入外部资源前进行安全审查与把关。

来源：提取自 redminwang 提交的停滞社区 PR #1232。

使用场景

• 用户提到“创建 Skill”、“构建 Skill”、“制作 Skill”或“搞个新 Skill”。
• 用户询问“有没有处理 X 的 Skill？”或“是否存在能做 Y 的 Skill？”
• 用户描述了一段工作流，而你准备建议创建一个新 Skill。
• 用户想要 Fork 或扩展现有的 Skill。

如果用户明确要求跳过搜索或直接从头创建，请予以确认并按请求的流程继续创建。

工作原理

步骤 1 - 捕获意图

提取以下信息：

• 该 Skill 应执行的任务。
• 触发使用该 Skill 的条件。
• 涉及的领域、工具、框架或数据源。
• 3 到 5 个搜索关键词及有用同义词。

步骤 2 - 搜索本地资源

优先搜索已安装和插件市场中的 Skill 名称。本地资源优先，因为它们已处于用户的环境中。

find ~/.claude/skills -maxdepth 2 -name SKILL.md 2>/dev/null | grep -iE "keyword|synonym"
find ~/.claude/plugins/marketplaces -path '*/skills/*/SKILL.md' 2>/dev/null | grep -iE "keyword|synonym"

然后搜索 frontmatter 中的描述：

grep -RilE "keyword|synonym" ~/.claude/skills ~/.claude/plugins/marketplaces 2>/dev/null

步骤 3 - 搜索远程资源

使用可用的 GitHub 和 Web 搜索工具。优先使用简洁的查询词：

gh search repos "claude code skill keyword" --limit 10 --sort stars
gh search code "name: keyword" --filename SKILL.md --limit 10

对于 Web 搜索，最多使用 3 个具针对性的查询，例如：

"claude code skill" keyword
"SKILL.md" keyword
"everything-claude-code" keyword

步骤 4 - 审查外部匹配项

在推荐任何外部 Skill 用于采纳或 Fork 之前：

• 阅读 SKILL.md 的 frontmatter 和使用说明。
• 排查是否存在未预期的 Shell 命令、文件写入、网络调用、凭据处理或软件包安装。
• 检查该仓库是否依然有人维护。
• 相比直接编辑插件市场的原始文件，更推荐将其复制到新的本地分支中并审查 diff。

步骤 5 - 结果排序

按以下标准对候选项排序：

1. Skill 名称完全匹配关键字。
2. 描述（description）匹配关键字或同义词。
3. 本地已安装或插件市场资源。
4. 具有近期活跃度的维护中 GitHub 资源。
5. 仅在 Web 上提及的内容。

最终列表最多保留 10 个结果。

步骤 6 - 提供决策选项

给用户提供一个简短的表格：

选项	含义
直接使用 (Use existing)	原样调用或安装匹配的 Skill。
Fork 或扩展 (Fork or extend)	复制最接近的 Skill 并对其进行修改。
从头创建 (Create fresh)	在确认没有相近匹配项后构建全新的 Skill。

只有在用户选择了该路径或搜索后未发现近义匹配项时，才创建新 Skill。

示例

结果表格

| # | Skill | Source | Why it matches | Gap |
| --- | --- | --- | --- | --- |
| 1 | article-writing | Local ECC | 撰写文章草稿和指南 | 未专注于发布日志（release notes） |
| 2 | content-engine | Local ECC | 多格式内容工作流 | 比实际所需的更重度 |
| 3 | blog-writer | GitHub | 带有近期 Commit 的博客写作 Skill | 需要安全审查 |

呈现给用户的总结

我找到了两个相近的本地匹配项和一个外部候选项。最契合的是 `article-writing`；它涵盖了草稿撰写和修改，但并不包含你要求的发布日志检查清单。我可以直接按原样使用它、将其 Fork 改造成发布日志变体，或者从头创建一个全新的 Skill。

反模式

• 在搜索合理可行的情况下，不要直接跳到新建 Skill。
• 切勿在未先阅读审查的情况下直接安装外部 Skill。
• 不要展示一长串未经排序且匹配度极低的候选列表。
• 不要把仅在 Web 上提及的内容直接当成可信来源。
• 切勿直接原地修改已安装的插件市场原始文件。

相关

• search-first - 构建前先搜索的通用工作流。
• skill-stocktake - 审计已安装 Skill 的健康度、重复项与缺口。
• agent-sort - 对现有的 Agent 和 Skill 进行分类与整理。