核心用法
skill-reviewer 是一个编排型审计工具，专为 Claude Code 的 .claude/commands/*.md 技能文件设计。用户通过触发关键词（如"审查 skill"、"检查 skill 质量"等）激活后，工具按四步流程执行：
1. 结构校验 — 运行内置 validate.sh 脚本检查 YAML frontmatter、name 格式、description 格式等
2. 内容质量审查 — 强制调用 skill-creator skill 进行深度评估（token 效率、渐进式披露、反模式检测等），不可用则必须停止并引导用户
3. 兼容性审计 — 核心职责，覆盖五大维度：跨平台兼容性（macOS/Windows 锁定）、跨 Agent 兼容性（Claude Code 专属工具引用）、npx skills 生态兼容性、工具引用规范、Prerequisites 声明完整性
4. 分级报告输出 — 按 Critical/High/Medium/Low 四级严重度生成 markdown 报告
显著优点
- 专业分工明确：不自建全部能力，而是智能委托给
validate.sh（结构）和skill-creator（质量），避免重复建设 - 兼容性覆盖全面：从平台层（macOS/Windows）、Agent层（Claude Code/Cursor等）、到生态层（npx skills marketplace）三层防护
- 强制依赖检查：对
skill-creator的硬性依赖声明避免了"带病审计"的风险 - 输出标准化：统一的报告格式便于 CI/CD 集成和批量处理
潜在缺点与局限性
- Claude Code 生态绑定：description 明确排除通用代码审查、PR 审查、CLAUDE.md 审查，适用范围较窄
- 委托工具依赖重：若
validate.sh或skill-creator不可用，流程会中断，需人工介入 - 无自主修复能力：纯审计工具，发现问题后需用户手动修复，不自动 patch
- npx skills 生态假设：部分检查项假设用户通过
npx skills安装，对其他安装方式（如手动 git clone）支持不明确
适合人群
- 维护 Claude Code 技能库的团队或个人开发者
- 需要批量审计技能兼容性的 DevOps/SRE 角色
- 计划将技能发布到 npx skills marketplace 的 contributor
- 多平台开发团队（macOS + Windows）需要确保技能跨平台可用
常规风险
- 审计完整性风险：
skill-creator不可用时流程强制停止，可能导致紧急场景下无法完成审计 - 平台误判风险：静态扫描可能误报平台锁定（如某些命令在 WSL 下实际可用）
- Agent 演进风险：Claude Code 工具术语变化时，兼容性检查清单可能滞后
- 报告解读成本：四级严重度（Critical/High/Medium/Low）需要用户具备一定判断力，Critical 项必须修复但 High 项可能被忽略
安全与可信度
来源为 Claude Code 官方或可信社区工具链，属于内置 skill 体系的一部分。审计行为本身只读不修改，风险可控。