核心功能
skill-reviewer 是一个 Claude Code skill 质量审计与兼容性检查的专业工具。它作为编排器,将结构校验委托给 validate.sh 脚本,内容质量审查委托给 skill-creator,自身专注于兼容性审计和报告生成。
显著优点
1. 清晰的职责分离:明确区分自执行、委托执行和禁止执行的范围,避免功能重叠
2. 标准化审计流程:四步流程(结构校验→内容质量→兼容性审计→输出报告)确保审查全面
3. 详细的兼容性检查:涵盖跨平台(macOS/Windows)、跨 Agent(Claude Code/MCP)、npx skills 生态、工具引用规范、Prerequisites 声明五个维度
4. 强制依赖声明:要求 Prerequisites 章节必须是 body 第一个 ## 章节,包含标准四列表格,并有被动检查说明
5. 结构化报告输出:统一的表格化报告格式,Critical/High/Medium/Low 四级严重度分级
潜在局限
1. 工具依赖严格:skill-creator 为强制依赖,不可用时必须停下引导用户,可能中断审计流程
2. 平台锁定风险:validate.sh 脚本和 npx skills 生态检查暗示对 npm/Node 生态的依赖
3. Claude Code 中心主义:工具引用规范要求"保留 Claude Code 工具术语",可能影响其他 Agent 的纯化使用
4. 被动检查模式:Prerequisites 采用"失败时引导"而非预检查,首次使用体验可能不佳
适合人群
- Claude Code 重度用户需要批量审查 skills
- 维护 npx skills 生态的开发者
- 需要确保 skill 跨平台可用性的团队
- Skill 作者进行自我质量把关
常规风险
- 误将一般代码审查、PR 审查、CLAUDE.md 审查带入 scope(文档已明确禁止)
- 跨 Agent 兼容性声明与实际行为不符(依赖 Claude Code 专属工具如
document-skills:前缀) - npx skills 生态检查在非 npm 环境中失效