/ 目录 / 演练场 / skill-doctor
← 全部服务器 ↗ GitHub
● 社区 marian2js ⚡ 即开即用

skill-doctor

作者 marian2js · marian2js/skill-doctor

在发货前放松您的Claude技能—前置物、资源参考、触发清晰度、评估卫生，严重程度得分为0-100。

skill-doctor是一种CLI ，用于扫描本地技能包并标记损害激活、可靠性或质量的问题。它检查YAML frontmatter和元数据，验证资源引用未中断，评估触发器描述的清晰度，并验证evals/evals.json。输出是0–100分，带有严重程度标签的调查结果；支持文本、JSON和仅分数模式，非常适合预提交、预路由或CI门控。

▶ 观看演示 📦 安装 💡 使用场景

为什么要用

核心特性

实时演示

实际使用效果

skill-doctor-skill.replay ▶ 就绪
0/0

安装

作者仓库 · Claude Skills 官方文档

使用场景

实战用法： skill-doctor

在发布到市场之前放松您的技能

👤 技能作者即将分享SKILL.md ⏱ ~15 min beginner

何时使用： 你完成了一项技能，并希望在其他人安装之前获得理智通行证。

前置条件
  • 节点18 + — nvm install 18
步骤
  1. 医生
    在技能根目录下运行技能医生。✓ 已复制
    → 分数+按严重程度列出的结果
  2. 修复严重程度较高的项目
    先修复高严重程度问题；重新运行，直至评分≥ 85。✓ 已复制
    → 得分攀升；批判消失

结果： 当您期望时激活的技能，并且没有损坏的引用。

注意事项
  • 追逐完美的100 — 低严重性项目（风格尼特）通常很好；专注于触发因素和资源
搭配使用： oaustegard-claude-skills

在CI中获得最低质量分数的技能存储库

👤 在一个存储库中维护多种技能的团队 ⏱ ~30 min intermediate

何时使用： 您经常运送技能，并希望防止漂移。

前置条件
  • GitHub操作（或同等功能） — 使用.github/workflows/进行回购
步骤
  1. 工作流程
    添加一个GH Actions作业，该作业运行技能博士，如果得分< 80则失败。✓ 已复制
    → 工作流文件已添加；在PR上运行
  2. 设置每个路径的严格性
    生产技能失败< 90 ；草稿允许< 70。✓ 已复制
    → 工作流程中的矩阵或条件阈值

结果： 降低技能质量的公关会在合并前被抓住。

注意事项
  • 将吧台锁得太高太早 — 从宽松的开始，随着发现的固定，在2-3个月内收紧
搭配使用： agent-skills-cli-skill

诊断技能未激活的原因

👤 存在激活问题的技能用户 ⏱ ~15 min beginner

何时使用： 你安装了一项技能，但克劳德从未触发过。

步骤
  1. 描述
    重写描述，以便在其中显示具体的用户任务关键字。✓ 已复制
    → 触发清晰度严重程度下降

结果： 更清晰的激活； Claude为正确的任务选择技能。

组合

与其他 MCP 搭配，撬动十倍杠杆

skill-doctor-skill + oaustegard-claude-skills

发布到市场之前的Lint

在本地运行skill-doctor ；然后向oaustegard/claude-skills打开PR。✓ 已复制
skill-doctor-skill + agent-skills-cli-skill

连锁技能医生与其他技能创作工具

使用agent-skills-cli搭建脚手架；使用skill-doctor在提交前进行验证。✓ 已复制
skill-doctor-skill + claude-skill

按照创作指南进行操作，然后使用棉绒

根据claude-skill指南进行写作；与技能医生进行验证。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
skill-doctor <path> skill directory path 在发布之前、在CI中或诊断激活问题 0

成本与限制

运行它的成本

API 配额
无—本地静态分析
每次调用 Token 数
无（ CLI ，不是API ）
费用
免费
提示
仅在已更改的目录上运行；在CI中，使用路径过滤器以避免在每个PR中扫描整个存储库。

安全

权限、密钥、影响范围

凭据存储： 证书
数据出站： 无—仅限本地分析

故障排查

常见错误与修复

医生说找不到SKILL.md

从技能根目录（包含SKILL.md的目录）运行，而不是从存储库根目录运行。

验证： ls SKILL.md in CWD
'evals/evals.json'架构失败

确保每个评估都有必填字段；最小存根比损坏存根更好。

验证： jq . evals/evals.json
编辑后分数没有提高

重新运行；如果发现仍然存在，请阅读严重程度和详细信息—有时修复会引入新的低严重程度问题。

验证： Diff the JSON reports between runs

替代方案

skill-doctor 对比其他方案

替代方案何时用它替代权衡
agent-skills-cli-skill您需要用于脚手架/管理技能的通用CLI工具不同的功能集；不是衬里
claude-skill您希望创作指南了解“好”是什么样的文档，而不是打印机

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills