skill-scout

Skill Scout

在建立新 Skill 之前請先使用此 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 中的 description：

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

步驟 3 - 搜尋遠端資源

使用現有的 GitHub 與網路搜尋工具。建議採用精簡的查詢語法：

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

進行網路搜尋時，最多使用 3 個具針對性的查詢，例如：

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

步驟 4 - 審查外部匹配項

在推薦採用或分支（fork）任何外部 Skill 之前：

• 閱讀 SKILL.md 的 frontmatter 與說明指引。
• 檢查是否有未預期的 Shell 指令、檔案寫入、網路呼叫、金鑰憑證處理或封包安裝。
• 確認該儲存庫（repository）是否仍有人維護。
• 優先將程式碼複製到全新的本地端分支進行 Diff 審查，而非直接修改市集原始檔案。

步驟 5 - 結果排序

依以下條件進行候選排序：

1. Skill 名稱精確匹配關鍵字。
2. Description 中包含關鍵字或同義詞。
3. 本地端已安裝或市集來源。
4. 有持續維護且近期有活動的 GitHub 來源。
5. 僅在網頁中提及。

最終清單上限為 10 筆結果。

步驟 6 - 提供決策選項

提供使用者一份簡短表格：

選項	意義
使用現成項目	直接呼叫或安裝匹配的 Skill。
分支或擴充	複製最接近的 Skill 並進行修改。
從頭建立	在確認無相近匹配項後，打造全新 Skill。

僅在使用者選擇該路徑或搜尋後未發現相近匹配項時，才建立新 Skill。

範例

結果表格

| # | Skill | 來源 | 匹配原因 | 差距 |
| --- | --- | --- | --- | --- |
| 1 | article-writing | 本地 ECC | 草擬文章與指南 | 未聚焦於版本發布說明 |
| 2 | content-engine | 本地 ECC | 多格式內容工作流程 | 比實際需求更為龐大 |
| 3 | blog-writer | GitHub | 近期有 Commit 的部落格撰寫 Skill | 需要進行安全性審查 |

面向使用者的摘要

我找到了兩個相近的本地端匹配項與一個外部候選項目。最符合的是 `article-writing`；它涵蓋了草稿撰寫與修訂，但未包含您要求的版本發布說明核對清單。我可以直接使用它、將其分支（fork）為版本發布說明變體，或是重新建立一個全新的 Skill。

反模式

• 在可進行合理搜尋時，切勿直接跳到建立新 Skill。
• 切勿在未先閱讀前就直接安裝外部 Skill。
• 切勿提供未經排序且匹配度低的大量長清單。
• 切勿將僅在網頁中提及的內容視為可信來源。
• 切勿直接原地修改已安裝的市集原始檔案。

相關內容

• search-first - 先搜尋再建置的通用工作流程。
• skill-stocktake - 審計已安裝 Skill 的健康度、重複項與缺口。
• agent-sort - 對現有的 Agent 和 Skill 進行分類與整理。