作者 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 卸载。
何时使用： 你完成了一项技能，并希望在其他人安装之前获得理智通行证。
结果： 当您期望时激活的技能，并且没有损坏的引用。
何时使用： 您经常运送技能，并希望防止漂移。
结果： 降低技能质量的公关会在合并前被抓住。
何时使用： 你安装了一项技能，但克劳德从未触发过。
结果： 更清晰的激活； Claude为正确的任务选择技能。
发布到市场之前的Lint
连锁技能医生与其他技能创作工具
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| skill-doctor <path> | skill directory path | 在发布之前、在CI中或诊断激活问题 | 0 |
医生说找不到SKILL.md从技能根目录（包含SKILL.md的目录）运行，而不是从存储库根目录运行。
ls SKILL.md in CWD'evals/evals.json'架构失败确保每个评估都有必填字段；最小存根比损坏存根更好。
jq . evals/evals.json编辑后分数没有提高重新运行；如果发现仍然存在，请阅读严重程度和详细信息—有时修复会引入新的低严重程度问题。
Diff the JSON reports between runs| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| agent-skills-cli-skill | 您需要用于脚手架/管理技能的通用CLI工具 | 不同的功能集；不是衬里 |
| claude-skill | 您希望创作指南了解“好”是什么样的 | 文档，而不是打印机 |