hekouwang-claude-skill-doctor-skill
Agent Skill 体检器，检查规范并评分
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：hekouwang-claude-skill-doctor-skill。 它的用途是：Agent Skill 体检器，检查规范并评分 完整的 Skill 内容见：https://321skill.com/skills/hekouwang-claude-skill-doctor-skill-x-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“检查我的skill规范吗”，然后提供你的SKILL.md文件内容。AI会输出一份评分卡，例如：“description触发质量：8/10（建议增加更多触发词）；篇幅控制：6/10（建议将长指令拆分为多个references/文件）……”并给出具体修复步骤。
介绍
很多开发者在使用 Claude/Agent 的 Skill 功能时，容易写出“巨石指令包”——把所有内容塞进一个 SKILL.md，导致触发效率低、可维护性差。本工具专门检查你的 SKILL.md 是否符合官方最佳实践，从 description 触发质量、篇幅控制、渐进披露（references/ 拆分）、脚本外置、可移植性（无硬编码绝对路径）、安全性（无硬编码密钥）等维度综合评分，并给出按优先级的修复建议，甚至可代为重构。
直接对 AI 说出“检查我的 skill”、“SKILL.md 体检”、“这个 skill 规范吗”等触发词，即可启动检查。你只需提供 SKILL.md 文件内容或仓库链接，AI 会生成一份详细的评分卡，指出每个维度得分和具体问题，并给出可操作的修复步骤。如果需要，还可以请求 AI 直接帮你重构代码。
适合所有使用 Claude/Agent Skill 进行智能体开发的开发者，尤其是那些 SKILL.md 文件越来越长、需要拆分优化的场景。也适合团队中负责维护 Skill 规范的文档工程师。
建议在 Skill 开发初期就使用本工具进行规范检查，避免后期重构成本。注意：本工具检查的是结构规范，不检查 Skill 的业务逻辑正确性。
核心特点
市面上大多数工具只检查代码质量，而本工具专门针对 Claude/Agent Skill 的 SKILL.md 文件，覆盖了 description 触发质量、渐进披露、脚本外置等 Skill 特有的最佳实践维度，并提供一键重构建议。
注意事项
不检查 Skill 的业务逻辑功能是否正确，也不支持非 SKILL.md 格式的指令文件。
常见问题
这个工具检查什么？
检查 SKILL.md 是否符合按需加载的指令包最佳实践，包括触发质量、篇幅、拆分、可移植性、安全性等，输出评分卡和修复建议。
我可以用它检查别人的 Skill 吗？
可以，只要你能提供 SKILL.md 内容或仓库链接。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/hekouwang-claude-skill-doctor-skill-x-2/raw/index.md 读取 hekouwang-claude-skill-doctor-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/hekouwang-claude-skill-doctor-skill-x-2/raw/index.md（查看排版版本）