Claude Skill 体检器（SKILL.md Doctor）
Claude/Agent Skill 质量体检与重构工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Claude Skill 体检器（SKILL.md Doctor）。 它的用途是：Claude/Agent Skill 质量体检与重构工具 完整的 Skill 内容见：https://321skill.com/skills/validator/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我检查一下这个SKILL.md，看看它合不合规'，然后粘贴你的SKILL.md内容。体检器会分析触发词质量、文件长度、是否拆分为references/子文件、脚本是否外置、有无硬编码路径和密钥，给出一份详细的评分卡，并按优先级列出修复建议，同时可以要求它直接帮你重构。
介绍
当你编写或维护一个 Claude/Agent Skill 时，是否担心它变成了杂乱无章的“单文件巨石”？这个 Skill 体检器能帮你快速诊断：它检查 description 触发质量、SKILL.md 篇幅是否合理、是否按渐进披露原则拆分为 references/ 子文件、脚本是否外置、是否有硬编码绝对路径或密钥等安全隐患。最终输出一份评分卡，并按优先级给出修复建议，甚至可以直接代为重构。
使用非常简单：你只需对 AI 说“检查我的 skill”或“SKILL.md 体检”，然后提供你的 SKILL.md 内容或仓库地址，体检器就会自动分析并给出报告。它支持多种触发词，包括“这个 skill 规范吗”、“audit skill”、“lint SKILL.md”、“我的 skill 太长了”等，覆盖了所有与 Skill 质量评估相关的请求。
适合所有编写或维护 Claude/Agent Skill 的开发者，尤其是智能体开发、全栈开发、运维工程师。无论你是想对齐官方最佳实践，还是希望优化技能结构以提升可维护性和可移植性，这个工具都能帮你快速定位问题、获得可操作的改进方案。
建议在每次创建或修改 Skill 后运行一次体检，确保它符合“按需加载的指令包”标准。体检器会给出具体的重构建议，你可以按优先级逐步优化。注意：它只检查结构、安全和可移植性，不评估 Skill 的功能逻辑是否正确。
常见问题
这个体检器能检查哪些问题？
检查 description 触发质量、SKILL.md 篇幅、渐进披露拆分、脚本外置、硬编码绝对路径、硬编码密钥等，并给出评分卡和修复建议。
需要上传文件吗？
不需要，直接对 AI 说出触发词，然后提供你的 SKILL.md 内容或仓库地址即可。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/validator/raw/index.md 读取 Claude Skill 体检器（SKILL.md Doctor） 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/validator/raw/index.md（查看排版版本）