LeoYeAI/agent-master-skills / skills/agent-skill-reviewer
skill-reviewer
Verified审核/审查 Skill 代码质量的专业工具。当用户说"检查 skill"、"审核 skill"、"review {名称} skill"、"skill 写得怎么样"、"帮我看看这个 skill 有什么问题"时使用。依据 Anthropic 官方指南进行结构验证、YAML 前置信息检查、描述质量评估、指令完整性审查,并输出详细的问题报告和改进建议。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 16.4 KB |
| _meta.json | config | 290 B |
| references/anthropic-skills-development-guide.md | markdown | 33.2 KB |
| references/checklist.md | markdown | 7.2 KB |
| references/official-guide-summary.md | markdown | 11.0 KB |
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` - 精简版
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Unverified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |