前言¶

给 Agent 写的 Skill 越来越多，真正卡人的往往不是模型能力，而是 SKILL.md 本身：元数据字段缺了、目录结构不规范、引用路径写错、工作流描述自相矛盾。这类问题在开发期不容易察觉，等发布或合入后才发现，排查成本就高了。

下面介绍的 Skill 质量检查，就是用来在发布或合入前，按 Agent Skills 开放标准与编写最佳实践，对一份 Skill 目录做一次系统审计，并输出分级的问题清单。

这是什么¶

Skill 质量检查是一个面向 Skill 文档的审计型 Skill，由社区开发者 user_0dea6a1d 发布，坐标 @user_0dea6a1d/check-skill-quality，当前版本 1.2.1，分类 dev-programming。它解决的问题是：把 Skill 文档质量检查这件事从”靠肉眼看”变成”按标准逐项过”。

它面向的对象是任意 Skill 目录。当你自己写了一个 Skill，或者在评审他人的 Skill、准备发布或合入前，都可以用它跑一遍。

核心功能¶

根据官方简介，这个 Skill 审计的维度覆盖了六个方面：

1、元数据：检查 SKILL.md 或相关元数据字段是否齐全、规范。
2、结构：检查目录组织、文件层级是否符合 Skill 的一般约定。
3、引用：检查文档中引用的路径、文件、链接是否真实存在且可解析。
4、工作流：检查描述的工作流是否清晰、步骤之间是否自洽。
5、脚本：检查附带脚本的调用方式、依赖与说明是否完整。
6、反模式：检查是否存在已知的不良写法，例如职责过载、描述与实际行为不符等。

审计结束后，它会输出三类结果：

• 阻断项：必须修复才能发布或合入的问题。
• 警告：不阻断但建议处理的问题。
• 修复建议：针对每条问题给出可操作的修改方向。

这种分级的意义在于，评审者不必把所有问题一视同仁地处理，可以先解决阻断项，再评估警告项。

安装与启用¶

该 Skill 标注 requires_api_key=false，启用时不需要额外配置 API Key。

需要说明的是，本次写作时官方页面未能抓取成功，因此具体的安装命令未能从官方资料核实。按 Agent Skills 的通用约定，这类 Skill 一般通过其分发渠道获取后放入本地 Skill 目录或通过 CLI 加载，但具体命令请以官方页面为准：

https://api.skillhub.cn/user_0dea6a1d/check-skill-quality

典型用法¶

官方简介未给出可复现的调用示例，因此这里不编造具体命令。从简介描述的行为来看，它的典型使用方式是：

1、在评审、打分、lint、审计或优化某个 Skill 目录时启用。
2、把目标 Skill 目录交给它，由它按上述六个维度逐项检查。
3、拿到阻断项、警告与修复建议后，按优先级逐条处理。

一个合理的使用时机是：你自己写完一个 Skill，在提交 PR 或发布之前先跑一遍，把阻断项清掉，再进入人工评审。这样评审者看到的就是相对干净的文档，注意力可以放在设计取舍而不是格式问题上。

适用场景与注意¶

适合谁：

• 编写自己的 Skill、希望在发布前做质量把关的开发者。
• 需要在合入前对他人 Skill 做评审的维护者。
• 想把 Skill 文档质量检查流程化、减少人工肉眼检查的人。

需要注意的限制：

• 它审计的是文档质量，不等同于功能测试。文档写得规范，不代表 Skill 在真实任务里表现就好；反过来，一个文档略有瑕疵但逻辑扎实的 Skill，也可能很实用。
• 审计结果依赖其所依据的标准与规则集，规则本身会有版本变化，阻断项和警告的判定标准应以启用时的口径为准。
• 官方页面在本次写作时未能访问，安装命令、最新示例与规则细节请到官方地址核对后再使用。
• 平台评分显示为 100000，下载量 3053、安装量 0。评分是平台体系内的数值，安装量为 0 意味着它可能还未被广泛采用，使用前建议先在自己的 Skill 目录上试跑。

小结¶

Skill 质量检查的价值在于，它把 Skill 文档的评审从”读一遍凭感觉”变成”按维度逐项过、按级别给结论”。对于经常写 Skill、或者需要评审他人 Skill 的人来说，把它作为发布或合入前的一道检查工序，能减少低质量文档流入后续环节。

官方地址：https://api.skillhub.cn/user_0dea6a1d/check-skill-quality