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/claude-skill-体检器-skill-md-doctor-x-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请检查一下我这个 Claude Skill 的 SKILL.md 文件是否规范。’ 它会分析你提供的 Skill 内容，生成一份详细的评分报告，指出在描述、结构、可移植性、安全性等方面的优缺点，并给出优先级的修复与重构建议。
介绍
Claude Skill 体检器（SKILL.md Doctor）是一款专注于评估和优化 Claude/Agent Skill 开发规范的工具。它解决了开发者在创建 Skill 时，因缺乏统一标准而导致代码结构混乱、可维护性差、安全性低等问题。通过分析 SKILL.md 文件，该工具能系统性地检查技能描述、文件结构、脚本外置、路径硬编码、密钥安全等多个维度，确保技能符合“按需加载的指令包”的最佳实践。
使用时，开发者只需向 AI 提出检查请求（如“检查我的 skill”），该工具便会自动分析提供的 Skill 内容，生成一份包含详细评分卡和优先级修复建议的报告。它不仅能指出问题，还能提供具体的重构方案，帮助开发者快速优化技能结构。
该工具特别适合智能体开发者、全栈开发者以及任何希望遵循官方规范来构建高质量、可复用、安全 Claude Skill 的团队或个人。对于刚开始接触 Skill 开发的新手，它能提供清晰的学习路径；对于有经验的开发者，它则是确保代码质量和团队协作一致性的得力助手。
建议在使用前，先准备好待检查的 SKILL.md 文件或 Skill 仓库链接。该工具的分析结果基于预设的最佳实践，开发者可根据自身项目实际情况酌情采纳建议。对于极其简单或特殊用途的 Skill，部分规范可能不适用，需灵活判断。
核心特点
与通用代码质量检查工具不同，它专门针对 Claude/Agent Skill 的特定结构和最佳实践（如渐进披露、脚本外置）进行深度检查，并能直接提供重构建议。相比同类 Skill 审查工具，它更侧重于“按需加载的指令包”这一核心理念，并提供从触发词质量到安全性的一站式评分卡。
注意事项
不适合评估 Skill 的业务逻辑正确性或实际功能效果，主要关注结构规范与开发实践。
常见问题
SKILL.md 体检器能检查哪些问题？
能检查描述触发质量、文件篇幅、渐进披露结构、脚本是否外置、是否存在硬编码绝对路径或密钥等规范性问题。
使用体检器需要安装什么？
通常无需额外安装，它是一个 Claude Skill，通过特定触发词在对话中直接调用即可。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/claude-skill-体检器-skill-md-doctor-x-2/raw/index.md 读取 Claude Skill 体检器（SKILL.md Doctor） 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/claude-skill-体检器-skill-md-doctor-x-2/raw/index.md（查看排版版本）