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/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
「检查我的 skill 是否规范」,它会要求你提供 SKILL.md 内容,然后输出评分卡,指出「description 触发质量不足」「篇幅过长,建议拆分到 references/ 目录」「脚本未外置」「存在硬编码绝对路径」等问题,并给出优先级排序的修复建议。如果你同意,它还可以直接帮你重构文件结构。
介绍
你写的 SKILL.md 是否变成了臃肿的“单文件巨石”?是否缺少合理的触发描述、渐进披露或安全性检查?这个 Skill 专门针对 Claude/Agent Skill 的 SKILL.md 文件进行全方位体检,从 description 触发质量、篇幅控制、references/ 拆分、脚本外置、可移植性、安全(无硬编码密钥)等六个维度打分,并给出按优先级排列的修复建议,甚至可代为重构。
使用非常简单:直接对 AI 说「检查我的 skill」「SKILL.md 体检」「这个 skill 规范吗」等唤醒词,AI 就会要求你提供 SKILL.md 内容(或粘贴文本),然后自动输出评分卡和详细改进方案。如果希望自动修复,可进一步授权 AI 进行代码级重构。
适合所有使用 Claude/Agent 的开发者,尤其是智能体开发者、全栈工程师和希望提升 Skill 质量的后端开发。无论你是刚入门还是已有经验,都能快速发现自己 SKILL.md 中的隐藏问题,并得到可落地的优化方向。
建议:本工具仅关注 SKILL.md 的结构与规范,不检查功能逻辑是否正确。使用前请确保你的 SKILL.md 内容完整;重构功能建议在版本控制下进行,以便回退。
核心特点
不同于通用的代码审查工具,它专门针对 Claude/Agent 的 SKILL.md 设计,检查维度紧扣“按需加载的指令包”最佳实践,并给出可自动执行的重构方案。
注意事项
需要用户提供完整的 SKILL.md 内容,无法处理非标准格式的技能包,也不评估功能逻辑的正确性。
常见问题
怎么触发这个体检?
直接说「检查我的 skill」「SKILL.md 体检」「这个 skill 规范吗」等关键词即可。
主要检查哪些方面?
description 触发质量、SKILL.md 篇幅、渐进披露(references/ 拆分)、脚本外置、可移植性(无硬编码路径)、安全(无硬编码密钥),并给出评分卡。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/claude-skill-体检器-skill-md-doctor/raw/index.md 读取 Claude Skill 体检器(SKILL.md Doctor) 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/claude-skill-体检器-skill-md-doctor/raw/index.md(查看排版版本)