Skill Reviewer 是一个专为 Claude Code 技能（即位于 .claude/commands/ 目录下的 .md 文件）设计的审计工具，用于全面评估技能的质量、结构完整性和跨平台兼容性。该工具通过自动化流程对技能进行系统化审查，确保其符合规范并能在不同开发环境中稳定运行。作为整个技能生态中的关键质量控制环节，Skill Reviewer 不仅检查技能的元数据格式，还深入验证其内容质量和依赖管理，从而提升技能的可复用性和健壮性。
该工具的核心职责在于协调多个已有工具完成审计工作：它调用内置的校验脚本进行结构和元数据验证，委托 skill-creator 进行内容质量分析，同时自身专注于兼容性审计。这种分工机制既保证了审计的全面性，又避免了重复造轮子。特别值得注意的是，内容质量审查是强制性的步骤，必须由 skill-creator 完成，否则整个审计流程将被视为不完整。
Skill Reviewer 的设计理念强调实用性与规范性并重。它不仅识别技术层面的兼容性问题，如平台锁定命令或跨代理依赖，还关注最佳实践，例如工具引用规范和外部依赖声明。最终输出统一格式化的审计报告，帮助开发者快速定位问题并采取修复措施。
核心功能特点
- 自动执行技能结构与元数据校验，包括 YAML frontmatter 格式、name 命名规范及描述字段限制
- 强制调用 skill-creator 进行深度内容质量审查，涵盖 token 效率、渐进式披露和反模式检测
- 独立完成跨平台与跨代理兼容性审计，识别 macOS-only 命令、MCP 依赖及 npx skills 生态适配问题
- 严格检查 Prerequisites 章节的完整性，要求明确列出 CLI、MCP、system 等类型依赖并提供可执行安装指引
- 生成标准化审计报告，按严重程度分级呈现问题，便于优先级排序和快速修复
适用场景
Skill Reviewer 主要适用于需要发布或共享 Claude Code 技能的场景，尤其是在构建技能市场或团队协作中。当开发者希望将自定义技能提交至 npx skills 生态或供他人使用时，必须经过此工具的全面审计以确保其符合分发标准。此外，在持续集成（CI）流程中集成 Skill Reviewer 可有效防止低质量或不兼容的技能进入主分支，提升整体代码库质量。
对于使用多种 AI 编码代理（如 Claude Code、Cursor 等）的开发者而言，Skill Reviewer 提供了统一的兼容性保障。它能发现那些仅在特定平台上可用的命令（如仅支持 macOS 的工具链），或引用了某代理专属 API 的代码片段，从而避免技能在其他环境中失效。这种跨代理兼容性检查尤其重要，因为技能往往需要在不同工具间迁移复用。
另一个典型应用场景是技能维护阶段的质量控制。随着项目演进，技能可能引入新的依赖或变更实现方式，定期运行 Skill Reviewer 可以帮助团队及时发现潜在风险。例如，若某个技能开始调用未声明的外部 CLI 工具，审计结果会立即提示补充 Prerequisites 章节，防止后续部署失败。总之，无论是技能发布前审核、CI/CD 流水线集成，还是日常开发中的质量门禁，Skill Reviewer 都是不可或缺的自动化质检工具。