作者 marian2js · marian2js/skill-doctor
在出貨前檢查您的 Claude 技能 — 前言、資源參考、觸發清晰度、評估衛生、嚴重性評分 0-100。
Skill-doctor 是一個 CLI，用於掃描本地技能包並標記損害激活、可靠性或品質的問題。 它檢查 YAML frontmatter 和元數據，驗證資源參考是否完整，評估觸發器描述以確保清晰度，並驗證「evals/evals.json」。 輸出為 0-100 分，並帶有嚴重性標記的結果；支援文字、JSON 和僅評分模式 — 非常適合預提交、預路由或 CI 門控。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"skill-doctor-skill": {
"command": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
],
"_inferred": false
}
}
}開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。
{
"mcpServers": {
"skill-doctor-skill": {
"command": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
],
"_inferred": false
}
}
}Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。
{
"mcpServers": {
"skill-doctor-skill": {
"command": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
],
"_inferred": false
}
}
}點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。
{
"mcpServers": {
"skill-doctor-skill": {
"command": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
],
"_inferred": false
}
}
}格式與 Claude Desktop 相同。重啟 Windsurf 生效。
{
"mcpServers": [
{
"name": "skill-doctor-skill",
"command": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
]
}
]
}Continue 使用伺服器物件陣列，而非映射。
{
"context_servers": {
"skill-doctor-skill": {
"command": {
"path": "npx",
"args": [
"-y",
"skill-doctor@latest",
"."
]
}
}
}
}加入 context_servers。Zed 儲存後熱重載。
claude mcp add skill-doctor-skill -- npx -y skill-doctor@latest .一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。
何時使用： 您完成了一項技能，並希望在其他人安裝它之前獲得理智通行證。
結果： 一項技能會在您期望的時候激活，並且沒有損壞的參考。
何時使用： 您經常傳授技能並希望防止漂移。
結果： 降低技能品質的 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 |