Skill Reviewer
Four-dimension quality auditor for AgentSkills.
Review Process
Step 1: Inventory & Classify
- 1.
find /path/to/skill -type f — list all files. If path doesn't exist or is empty, abort with error. - Read
_meta.json or .clawhub/origin.json if present (source, version, author info). - Read SKILL.md in full.
- Classify skill type per
references/weight-adjustment.md → determine weights.
Step 2: Scan
- 1. SKILL.md (full read)
- scripts/ (full read, do NOT execute)
- references/ (full read if ≤10 files or ≤50KB total; spot-check otherwise)
- assets/ (list filenames, flag non-asset file types: .sh/.py/.exe/.bat/.ps1 in assets/ = suspicious)
- Other files (.json, dotfiles, symlinks) — inspect each
Step 3: Score Each Dimension
Load reference files: references/design-quality.md, references/content-quality.md, references/security.md, references/usability.md.
For each dimension, walk the checklist and score per the rubric. Cite [file:line] for each finding.
Security shortcut: Run grep sweeps for CRITICAL patterns first (see security.md C1-C11). If any CRITICAL found → D3=1, note it, but still score remaining dimensions — don't skip them.
Orphan file check (security.md): After reading SKILL.md, cross-reference all mentioned files against the actual file list. Flag orphans.
Step 4: Calculate & Verdict
Weighted total = Σ(dimscore × adjustedweight)
| Verdict | Condition |
|---|
| ✅ PASS | Total ≥ 8 AND every dimension ≥ 6 AND no CRITICAL findings |
| 🔧 REVISE |
Total < 8 OR any dimension < 6 OR any CRITICAL finding |
CRITICAL auto-revise: Even if total ≥ 8, any security CRITICAL finding forces REVISE.
Report Format
Use list format (not tables — compatible with all platforms):
PASS:
CODEBLOCK0
REVISE:
CODEBLOCK1
References
- -
references/weight-adjustment.md — type classification + weight matrix - INLINECODE10 — D1 checklist + rubric + scoring rules
- INLINECODE11 — D2 checklist + rubric + scoring rules
- INLINECODE12 — D3 pattern table + detection commands
- INLINECODE13 — D4 checklist + rubric + scoring rules
技能审校器
AgentSkills的四维质量审核工具。
审校流程
第一步：盘点与分类
- 1. find /path/to/skill -type f — 列出所有文件。如果路径不存在或为空，则中止并报错。
- 读取_meta.json或.clawhub/origin.json（如果存在），获取来源、版本、作者信息。
- 完整读取SKILL.md。
- 根据references/weight-adjustment.md对技能类型进行分类 → 确定权重。
第二步：扫描
- 1. SKILL.md（完整读取）
- scripts/（完整读取，不执行）
- references/（如果文件数≤10或总大小≤50KB则完整读取；否则抽样检查）
- assets/（列出文件名，标记非资源文件类型：assets/中的.sh/.py/.exe/.bat/.ps1 = 可疑）
- 其他文件（.json、点文件、符号链接）— 逐一检查
第三步：各维度评分
加载参考文件：references/design-quality.md、references/content-quality.md、references/security.md、references/usability.md。
针对每个维度，逐项检查清单并按评分标准打分。每个发现需引用[文件:行号]。
安全快捷方式： 首先运行grep扫描关键模式（参见security.md C1-C11）。如果发现任何关键问题 → D3=1，记录在案，但仍需对剩余维度评分 — 不可跳过。
孤立文件检查（security.md）： 读取SKILL.md后，将所有提及的文件与实际文件列表进行交叉比对。标记孤立文件。
第四步：计算与判定
加权总分 = Σ(维度得分 × 调整后权重)
| 判定结果 | 条件 |
|---|
| ✅ 通过 | 总分 ≥ 8 且 每个维度 ≥ 6 且 无关键发现 |
| 🔧 打回 |
总分 < 8 或 任一维度 < 6 或 存在关键发现 |
关键问题自动打回： 即使总分 ≥ 8，任何安全关键发现都强制判定为打回。
报告格式
使用列表格式（非表格 — 兼容所有平台）：
通过：
【技能审校通过】
技能：{name}
路径：{path}
类型：{type}
综合得分：{score}/10
审校日期：{date}
• 设计质量（{w1}%）：{d1}/10 — {简要说明}
• 内容质量（{w2}%）：{d2}/10 — {简要说明}
• 安全性（{w3}%）：{d3}/10 — {简要说明}
• 实用性（{w4}%）：{d4}/10 — {简要说明}
亮点：
打回：
【技能审校打回】
技能：{name}
路径：{path}
类型：{type}
综合得分：{score}/10
审校日期：{date}
⚠️ 判定维度：
• 设计质量（{w1}%）：{d1}/10
• 内容质量（{w2}%）：{d2}/10
• 安全性（{w3}%）：{d3}/10
• 实用性（{w4}%）：{d4}/10
具体问题：
- - [D1] {问题} — {文件}:{行号}
- [D3] 🔴 关键: {问题} — {文件}:{行号}
改进方向：
达标标准：
参考文件
- - references/weight-adjustment.md — 类型分类 + 权重矩阵
- references/design-quality.md — D1检查清单 + 评分标准 + 评分规则
- references/content-quality.md — D2检查清单 + 评分标准 + 评分规则
- references/security.md — D3模式表 + 检测命令
- references/usability.md — D4检查清单 + 评分标准 + 评分规则
