用途
Skill Reviewer 用于对已存在的 Claude Code 技能进行审查、验证、泛化和发布,使其符合公开分发的最佳实践。若要从零创建全新技能,应使用配套的 skill-builder 技能。
主要能力
- 结构校验:定义技能目录应包含 SKILL.md(核心指令)、README.md(人类可读文档与安装说明)、CHANGELOG.md(Keep a Changelog 格式的版本历史),以及可选的 references/、scripts/、hooks/、examples/。
- 行为分类:每个技能必须声明行为类型:Autonomous Execution(EXECUTE, DON'T ASK)、Guided Decision(ASK, THEN EXECUTE)、Interactive Exploration(ASK THROUGHOUT)、Configurable Enforcement(USER-CONFIGURED),并给出决策树与适用示例。
- 泛化检查:公开发布的技能不得包含硬编码项目名、UUID/ID、个人 API 端点、公司特定逻辑、内部团队引用;应改为环境变量、可配置 URL、通用模式与通用示例。文档、案例、模板均须使用占位符(如 [ISSUE-ID]、<your-uuid>)。
- 敏感信息管理:涉及密钥的技能应使用 Varlock,提供 .env.schema、.env.example,并避免 echo $API_KEY、cat .env 等会暴露密钥的命令。
- 更新工作流:审计项目特定内容 → 提取为环境变量 → 重命名项目特定函数 → 更新文档 → 运行校验脚本 → 按 semver 升级版本并更新 CHANGELOG。
- 发布流程:确认 README 与 CHANGELOG 齐全,提交并推送,创建 GitHub Release 与标签;技能包可使用 <skill-name>/v<version> 标签约定避免冲突。
- 版本漂移审计:发布技能包前核对各技能版本与来源是否一致。
- 批量查找替换:重命名术语时先大小写不敏感 grep,注意多种大小写变体;含尖括号的替换应使用 sed。
使用方式
资料提供了校验脚本命令 npx tsx scripts/validate-skill.ts path/to/skill,以及一系列 grep、sed、git、gh release 检查与发布命令。安装方式提及 Claude Code 插件市场流程与 skillsmith install 备选流程。具体操作步骤见正文清单。
适用场景
- 准备公开发布技能前的质量与合规检查
- 将内部项目专用技能泛化为通用技能
- 技能版本升级、CHANGELOG 与 GitHub Release 发布
- 技能包版本一致性与标签管理
限制
资料未说明该技能的运行环境、依赖版本、支持的平台范围、收费或许可信息,暂未提供。