SuperAPI AI 工具集

claude-skill-review

编程与开发

查看项目

更新于 10-16 10:03

技能介绍

用途

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] [问题说明] [处理方法]

限制

资料未提供安装命令、代码示例、官方文档链接、许可证、价格等信息,暂未提供。