核心用法
skill-reviewer 是专为 Claude Code 技能生态系统设计的质量审计编排器。它采用三阶段审计流程：首先通过内置脚本进行结构校验，然后委托 writing-skills 进行深度内容质量审查，最后由自身专注执行跨平台、跨 Agent、跨生态的兼容性审计。
用户通过触发词「审查 skill」「review skill」等激活该 skill。审计覆盖六大维度：YAML frontmatter 规范、token 效率与渐进式披露、平台锁定模式（macOS/Windows 兼容性）、Claude Code 专属工具引用、npx skills 生态注册规范，以及 Prerequisites 声明完整性。
显著优点
1. 分层架构设计：明确区分「委托执行」与「核心自查」，避免重复造轮子，充分利用 writing-skills 的专业能力
2. 标准化输出：提供结构化的 Markdown 报告模板，含总览表格与分级问题清单（Critical/High/Medium/Low）
3. 前置依赖强制：对 writing-skills 的硬性要求确保审计完整性，拒绝「降级执行」
4. 生态视角：不仅检查单机可用性，更关注 marketplace.json 注册、symlink、跨 skill 依赖等分发层面的兼容性
5. 被动检查机制：Prerequisites 章节明确要求「执行失败时直接引导用户」，而非甩锅文档
潜在缺点与局限性
1. 依赖外部 skill：核心审计链依赖 writing-skills，若该 skill 质量波动或弃坑，将影响本 skill 可用性
2. 无自动化 CI 集成：当前设计为交互式审计，缺乏 GitHub Actions 等自动化检查能力
3. 平台覆盖有限：兼容性检查清单基于 references/compatibility-checklist.md，若该文档未及时更新（如新增 Linux ARM 场景），审计将滞后
4. 无修复建议自动化：仅输出诊断报告，不提供自动修复补丁
适合人群
- Claude Code skill 作者：发布前质量把关
- npx skills 生态维护者：批量审查 marketplace 提交
- 企业内部治理：建立 skill 准入标准
常规风险
- 假阴性风险：validate.sh 或 checklist.md 未及时更新可能导致漏检
- 误报风险：特定场景下的平台锁定可能是设计意图（如仅 macOS 的工具封装），需人工复核
- 供应链风险：writing-skills 的不可用将阻塞完整审计流程