Claude Skill 体检器（SKILL.md Doctor）
Agent Skill 质量体检与重构工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Claude Skill 体检器（SKILL.md Doctor）。 它的用途是：Agent Skill 质量体检与重构工具 完整的 Skill 内容见：https://321skill.com/skills/claude-skill-体检器-skill-md-doctor-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'检查我的skill / 这个skill规范吗'，它会自动分析你提供的SKILL.md内容，从触发质量、篇幅、拆分、外置脚本、可移植性、安全六个维度打分，并给出按优先级排序的修复建议。如果你说'帮我重构这个skill'，它还会生成拆分后的references/目录结构和优化后的description。
介绍
你是否写过一份长长的 SKILL.md，却不确定它是否真的符合 Claude/Agent Skill 的最佳实践？这个工具帮你快速给 Skill 做一次全面体检。它会检查 description 触发词是否精准、SKILL.md 篇幅是否过长、是否使用了渐进披露（references/ 拆分）、脚本是否外置、是否存在硬编码绝对路径和密钥等安全问题，并给出清晰的评分卡和按优先级排序的修复建议。如果你愿意，它还可以直接帮你把巨石文件的 Skill 拆分成按需加载的指令包。
使用非常简单：你只需要把要检查的 SKILL.md 内容或路径告诉它，或者直接说出「检查我的 skill」「SKILL.md 体检」「这个 skill 规范吗」等触发词，工具就会自动开始分析。它支持多种触发方式，几乎任何“评估/审查/优化某个 Agent Skill 质量或结构”的请求都会激活。
这个工具最适合正在开发或维护 Claude / 通用 Agent Skill 的开发者，尤其是那些技能文件已经变得臃肿、难以维护，或者想从零开始写一份高质量 SKILL.md 的人。无论你是智能体开发者、全栈工程师还是 AI 应用爱好者，都能从中受益。
注意：这个体检器只关注 SKILL.md 文件的结构、可移植性和安全性，不评估技能的功能逻辑正确性。如果你的 Skill 本身逻辑有 bug，需要先用其他方式调试。另外，它建议的拆分方案需要你手动确认后再应用。
核心特点
同类工具大多只检查代码质量，而这个是专门针对 Agent Skill 的 SKILL.md 文件，覆盖了 description 触发质量、渐进披露、脚本外置、可移植性等 Agent 特有维度，并且能直接代为重构拆分。
注意事项
只适用于 SKILL.md 格式的 Agent Skill，不适用于普通代码项目或非指令包类型的配置。
常见问题
这个工具怎么用？
直接对 AI 说「检查我的 skill」「SKILL.md 体检」或类似触发词，然后提供你的 SKILL.md 内容或路径即可。
它检查哪些方面？
检查 description 触发质量、SKILL.md 篇幅、渐进披露（references/ 拆分）、脚本外置、可移植性（无硬编码绝对路径）、安全（无硬编码密钥），并给出评分卡和修复建议。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/claude-skill-体检器-skill-md-doctor-x/raw/index.md 读取 Claude Skill 体检器（SKILL.md Doctor） 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/claude-skill-体检器-skill-md-doctor-x/raw/index.md（查看排版版本）