作者 marian2js · marian2js/skill-doctor
在出貨前檢查您的 Claude 技能 — 前言、資源參考、觸發清晰度、評估衛生、嚴重性評分 0-100。
Skill-doctor 是一個 CLI，用於掃描本地技能包並標記損害激活、可靠性或品質的問題。 它檢查 YAML frontmatter 和元數據，驗證資源參考是否完整，評估觸發器描述以確保清晰度，並驗證「evals/evals.json」。 輸出為 0-100 分，並帶有嚴重性標記的結果；支援文字、JSON 和僅評分模式 — 非常適合預提交、預路由或 CI 門控。
何時使用： 您完成了一項技能，並希望在其他人安裝它之前獲得理智通行證。
結果： 一項技能會在您期望的時候激活，並且沒有損壞的參考。
何時使用： 您經常傳授技能並希望防止漂移。
結果： 降低技能品質的 PR 在合併之前會被捕獲。
何時使用： 你安裝了一項技能，但克勞德從未觸發它。
結果： 啟動更清晰；克勞德為正確的任務選擇技能。
發佈到市場之前檢查
將技能醫生與其他技能創作工具連結起來
| 工具 | 輸入參數 | 何時呼叫 | 成本 |
|---|---|---|---|
| skill-doctor <path> | skill directory path | 在發布之前、在 CI 中或診斷啟動問題 | 0 |
醫生說找不到 SKILL.md從技能根目錄（包含 SKILL.md 的目錄）運行，而不是從儲存庫根目錄運行。
ls SKILL.md in CWD“evals/evals.json”架構失敗確保每個 eval 都有必填欄位；一個最小的存根總比損壞好。
jq . evals/evals.json修改後分數沒有提高重新運行；如果發現仍然存在，請閱讀嚴重性和詳細資訊 - 有時修復會引入新的低嚴重性問題。
Diff the JSON reports between runs| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| agent-skills-cli-skill | 您需要用於鷹架/管理技能的通用 CLI 工具 | 不同的功能集；不是短絨毛棉 |
| claude-skill | 您希望創作指南了解「好」是什麼樣子 | 文檔，而不是 linter |