Skip to content

LeoYeAI/agent-master-skills / skills/agent-skill-reviewer

skill-reviewer

Verified

审核/审查 Skill 代码质量的专业工具。当用户说"检查 skill"、"审核 skill"、"review {名称} skill"、"skill 写得怎么样"、"帮我看看这个 skill 有什么问题"时使用。依据 Anthropic 官方指南进行结构验证、YAML 前置信息检查、描述质量评估、指令完整性审查,并输出详细的问题报告和改进建议。

references/checklist.md

View on GitHub
# Skill 审核检查清单

基于 Anthropic 官方 Skills 开发指南

## 快速审核清单

### 结构检查(4 分)

- [ ] 文件夹用了 kebab-case 命名(如 `my-skill`)
  - ❌ `MySkill` ❌ `my_skill` ❌ `My Skill`
  - ✅ `my-skill`
- [ ] `SKILL.md` 文件存在(精确拼写,区分大小写)
  - ❌ `skill.md` ❌ `SKILL.MD`
  - ✅ `SKILL.md`
- [ ] 无 `README.md` 在技能文件夹内
- [ ] 可选文件夹命名规范(如存在)

**得分:__/4**

---

### 可选文件夹命名(如果存在)

- [ ] `scripts/` - 全小写复数,无空格/下划线
  - ❌ `Scripts` ❌ `script` ❌ `scripts_backup`
  - ✅ `scripts`
- [ ] `references/` - 全小写复数,无空格/下划线
  - ❌ `References` ❌ `reference` ❌ `refs`
  - ✅ `references`
- [ ] `assets/` - 全小写复数,无空格/下划线
  - ❌ `Assets` ❌ `asset` ❌ `asset_files`
  - ✅ `assets`

---

### YAML 前置信息检查

**必填字段验证:**
- [ ] YAML 分隔符完整(开头和结尾都有 `---`)
- [ ] `name` 字段:kebab-case、无空格、无大写
  - ❌ `name: MySkill`  ✅ `name: my-skill`
- [ ] `name` 不以 "claude" 或 "anthropic" 开头
- [ ] `description` 字段存在且非空
- [ ] 无 XML 标签(`<` `>`)

**Description 质量评分(8 分):**
- [ ] [2 分] 开头说明做什么(主动动词)
  - 好:"分析 Figma 设计文件并生成开发者交接文档"
  - 差:"这是关于 Figma 的技能"
- [ ] [2 分] 包含触发条件("当用户...时")
  - 好:"当用户上传 .fig 文件或询问设计规格时使用"
  - 差:无触发条件
- [ ] [2 分] 具体范围(提及具体工具、操作或场景)
  - 好:"Figma 设计文件、.fig、组件文档"
  - 差:"帮助处理项目"
- [ ] [2 分] 合理长度(50-200 字符,不超过 1024)
  - 太短:无搜索价值
  - 太长:被截断

**得分:__/8**

---

### 组织评分(6 分)

**按任务/场景组织(而非按抽象概念):**
- [ ] [2 分] 按任务/操作组织章节
  - 好:"## 编码和解码" → "## 检查字符" → "## 转换格式"
  - 差:"## 理论" → "## 类型" → "## 高级"
- [ ] [2 分] 常见操作优先
  - 好:基础用法 → 变体 → 高级 → 边界情况
  - 差:配置说明 → 理论背景 → 最后才是基础用法
- [ ] [1 分] 章节自包含(可独立使用)
- [ ] [1 分] 深度一致(不混用 h2 与 h4 随机跳转)

**得分:__/6**

---

### 主体指令(6 分)

**必须包含:**
```
[ ] 清晰的工作流程或步骤说明
[ ] 至少一个使用示例
[ ] 错误处理或故障排查指南
```

**推荐包含(不扣分):**
```
[ ] 预期输出说明
[ ] 多个场景示例
[ ] 参考文档链接
[ ] "使用场景"或"When to Use"部分
```

**得分:__/6**

---

### 示例质量(9 分)

**示例密度计算:**
```
总行数:___
代码块数量:___
密度:每 ___ 行 1 个代码块

参考目标:每 5-30 行 1 个代码块
< 5 行/块:可能过于碎片化(短命令集或多命令速查除外)
> 40 行/块:需要更多示例
```

**示例密度评分:**
```
[3] 密度在 5-30 行/块范围内
[2] 密度略低(30-40 行/块)或略高(3-5 行/块)
[0] 密度严重不足(>40 行/块)或过高(<3 行/块)
```

**每个示例质量评分(0-3 分):**
```
[ ] 语言标签正确(```bash, ```python 等)
[ ] 语法正确,命令可执行
[ ] 展示了预期输出或结果说明
[ ] 使用真实值(非 foo/bar/baz)
[ ] 无占位符(TODO, FIXME, xxx)
[ ] 自包含或有设置说明

0 分:broken 或有误导性
1 分:可用但简陋(无输出/上下文)
2 分:良好(正确,有输出或说明)
3 分:优秀(可直接复制,真实,覆盖边界)
```

**示例质量得分 = 所有示例平均分 × 密度分 / 3 = __/9**

---

### 可执行性(10 分)

核心问题:Agent 能否按照这些指令产生正确结果?

```
[3] 使用祈使句("运行 X"、"创建 Y")
    非:"可以考虑..."或"建议..."或"You might..."

[3] 步骤顺序合理(前置条件在行动之前)

[2] 错误处理(说明失败时怎么做)

[2] 输出/结果描述(如何验证成功)
```

**得分:__/10**

---

### 渐进式披露(3 分)

```
[ ] SKILL.md 控制在 500 行以内
    500-600 行:给出提醒,不扣分
    超过 600 行:扣分
[ ] 详细文档是否在 `references/` 中
[ ] 大文件(>300 行)有目录或结构说明
```

**得分:__/3**

---

### Tips 评分(8 分)

**技巧部分质量评估:**

- [ ] [2 分] 5-10 条技巧
  - 少于 5 条:覆盖不足
  - 多于 10 条:可能不够精炼

- [ ] [2 分] 技巧非显而易见
  - 好:"Makefile 头号陷阱:缩进必须用 Tab,不能用空格"
  - 差:"确保测试你的代码"

- [ ] [2 分] 技巧具体可执行
  - 好:"使用 flock 防止 cron 任务重叠执行"
  - 差:"小心并发执行"

- [ ] [1 分] 技巧不矛盾主体内容

- [ ] [1 分] 技巧覆盖特定主题的陷阱/踩坑点

**得分:__/8**

---

### (可选)Metadata 参考

> 仅当 skill 包含 metadata 时检查,作为额外参考,不计入总分

- [ ] emoji 与技能主题相关
- [ ] requires 列出技能实际使用的工具
- [ ] os 数组准确
- [ ] JSON 格式有效

(仅供参考,不计分)

---

## 评分总结

```
总分计算:
─────────────────────────────────────
结构检查              __       4
Description 质量       __       8
组织评分              __       6
主体指令              __       6
示例质量              __       9
可执行性              __      10
渐进式披露            __       3
Tips 评分             __       8
─────────────────────────────────────
总计                 __      54

转换为百分制:总分 × 1.85 = ___/100

评级:
  85+  优秀 — 可直接发布
  70-84 良好 — 需要小改进
  50-69 一般 — 需要明显改进
  < 50  较差 — 需要重大修改

结论:{PUBLISH / REVISE / REWORK}
```

---

## 缺陷快速判断

### 严重缺陷(立即阻止发布)

- [ ] YAML 解析错误
- [ ] 缺少 name 或 description 字段
- [ ] 代码示例语法错误
- [ ] 误导性描述(承诺未覆盖的功能)

### 主要缺陷(发布前应修复)

- [ ] 缺少"使用场景"部分
- [ ] 大段文字(>10 行)无示例
- [ ] 示例缺少语言标签
- [ ] 缺少 Tips/技巧部分
- [ ] 按抽象概念组织而非任务

### 次要缺陷(建议修复)

- [ ] 占位符值(foo, bar, TODO)
- [ ] 格式不一致
- [ ] 缺少交叉引用
- [ ] 过时的命令/语法

---

## 快速审核模板

```markdown
## 快速审核:{skill-name}

**结构**:[通过/问题:...]
**Description**:[强/弱:原因]
**示例**:[_ 个代码块,共 _ 行 — 密度 正常/低/高]
**可执行性**:[可以/不可以遵循,因为...]
**首要缺陷**:[最应该修复的问题]
**评分**:__/100
**结论**:[PUBLISH / REVISE / REWORK]
```

---

## 官方指南参考

- `references/anthropic-skills-development-guide.md` - 完整版
- `references/official-guide-summary.md` - 精简版
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexUnverifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall