用途
claude-skill-review 用于审查 Claude Code 技能(SKILL.md)的质量,依据官方最佳实践进行评审。
何时使用
- 当 PR 中包含 SKILL.md 文件时
- 当被要求检查技能质量时
- 创建新技能时的自我评审
官方文档参考
资料中给出以下参考文件路径:
- 技能概览: @references/01_skill_overview.md
- 最佳实践: @references/02_best_practices.md
评审步骤
步骤1:前端元数据验证(Critical)
检查字段:
- name:必需,最长64字符,仅小写字母、数字和连字符,不能使用保留字(anthropic、claude)
- description:必需、非空、最长1024字符
Critical 判定:缺少前端元数据、name 格式非法、description 为空。
步骤2:description 质量检查(Major/Minor)
必需元素(Major):说明做什么(具体功能);说明何时使用(触发条件)。
质量检查(Minor):建议使用第三人称(“~します”“~を処理する”);包含具体关键词;避免第一/第二人称(“お手伝いします”);避免模糊表达(“ドキュメントに役立ちます”)。
步骤3:目录结构检查(Critical/Major)
面向市场分发的正确布局: {domain}/skills/{skill-name}/ ├── SKILL.md # 必需 ├── references/ # 可选 └── scripts/ # 可选
Critical:错误放置(如 ~/.claude/skills/ 为用户安装位置;.claude/skills/ 为项目专用技能)。 Major:命名违规(避免 CamelCase 或 snake_case,应使用 kebab-case,推荐动名词形式如 processing-pdfs)。
步骤4:SKILL.md 正文质量检查(Minor)
建议:不超过500行(超出则拆分为其他文件);包含具体示例;有明确的工作流/步骤;全文术语一致;省略 Claude 已知的常识。
步骤5:引用文件检查(Major/Minor)
引用的文件均需存在(Major);引用最多一层深度(Minor);100行以上的文件应有目录(Minor);文件路径使用正斜杠(Minor)。
步骤6:应避免的模式检测
模式与重要度:
- 时效性信息(如“2025年8月以后为~”)— Major
- 并列过多选项 — Minor
- 提示注入漏洞 — Critical
- 深层嵌套引用(2层以上)— Minor
- Windows 风格路径(反斜杠)— Minor
评分标准
- 10/10:通过所有检查项
- 8-9/10:Minor 问题1-2个
- 6-7/10:Major 问题1个,或 Minor 问题3个以上
- 5以下/10:存在 Critical 问题,或多个 Major 问题
输出格式
📦 Skill Quality: X/10
前端元数据
- [✅/❌] name: [评价评论]
- [✅/❌] description: [评价评论]
目录结构
- [✅/❌] 放置: [评价评论]
- [✅/❌] 命名: [评价评论]
SKILL.md 正文
- [✅/❌] 行数: [X行]
- [✅/❌] 是否有示例: [评价评论]
- [✅/❌] 工作流: [评价评论]
引用文件
- [✅/❌] 存在性确认: [评价评论]
- [✅/❌] 嵌套深度: [评价评论]
检测到的问题
| 重要度 | 问题 | 建议处理 |
|---|---|---|
| [Critical/Major/Minor] | [问题说明] | [处理方法] |
限制
资料未提供安装命令、代码示例、官方文档链接、许可证、价格等信息,暂未提供。