Claude Skill 体检器（SKILL.md Doctor）
一个用于审查和优化Claude Agent Skill结构规范的AI工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Claude Skill 体检器（SKILL.md Doctor）。 它的用途是：一个用于审查和优化Claude Agent Skill结构规范的AI工具。 完整的 Skill 内容见：https://321skill.com/skills/agent-spec-validator/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我检查一下这个Skill的SKILL.md文件是否规范。” 它会分析你提供的Skill结构，生成一份包含描述触发质量、文件拆分、安全性等维度的评分卡，并列出高优先级的修复建议。你还可以接着说：“请根据建议帮我重构它。” AI会尝试输出一个优化后的SKILL.md草案。
介绍
这个Skill旨在解决开发者创建Claude Agent Skill时，因结构不规范导致的维护困难、复用性差和潜在安全问题。它通过分析SKILL.md文件，评估其是否符合“按需加载的指令包”的最佳实践，帮助开发者构建更健壮、可移植的Skill。
使用时，只需向AI提出审查Skill的请求，例如“检查我的skill”或“这个skill规范吗”，该Skill便会自动触发。它会深入分析你的Skill描述、文件结构、脚本外置情况、路径和密钥硬编码等问题，并生成一份详细的评分报告。
它非常适合智能体开发者、全栈开发者和运维工程师，特别是那些希望遵循官方规范、提升Skill质量和团队协作效率的开发者。对于需要快速验证新Skill结构或重构遗留Skill的场景尤为有用。
建议在使用前准备好待审查的SKILL.md文件或其内容。该工具主要提供结构审查和建议，具体的代码重构需要开发者手动或结合其他工具完成。审查时请确保不包含真实的敏感密钥信息，以防泄露。
核心特点
与通用代码审查工具不同，它专门针对Claude Agent Skill的SKILL.md结构和官方最佳实践进行深度检查，并提供按优先级排序的、可操作的修复建议，甚至能代为重构。
注意事项
该Skill主要关注Skill的结构和规范，不涉及Skill内部业务逻辑的功能性测试或性能评估。
常见问题
Claude Skill 体检器能检查什么？
主要检查SKILL.md的描述质量、文件篇幅、渐进披露（references/拆分）、脚本外置、可移植性（无硬编码路径）和安全性（无硬编码密钥）。
如何使用它来优化我的Skill？
直接对AI说“检查我的skill”或“skill拆分”，它会给出评分和具体重构建议，并可按照指示代为重构SKILL.md结构。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agent-spec-validator/raw/index.md 读取 Claude Skill 体检器（SKILL.md Doctor） 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agent-spec-validator/raw/index.md（查看排版版本）