Content
86%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
An exemplary compact, disciplined SKILL.md body: lean prose, a concrete decision ladder, explicit pre-edit budgeting, and a strong verification stance that rejects stale evidence. The only meaningful gap is the absence of a small worked example and an explicit verify-and-retry loop, which keep actionability and workflow clarity at 4 rather than 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~49-line body is lean: every section (核心规则, 决策阶梯, 变更预算, 安全边界, 输出契约, 验证) adds guidance Claude does not already have, with zero padding and no explanation of basic concepts. It neither dips into anchor 4's 'minor over-explanation' territory nor needs tightening anywhere. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is largely executable: the 决策阶梯 is a concrete 7-step ordered checklist ("项目中是否已有实现…" → "标准库是否足够?" → "已安装依赖是否足够?"), and 验证 names concrete evidence types ("新鲜的定向测试、validator、哈希、渲染结果或直接行为检查"). It falls short of 5 because no worked example is given — e.g. a sample 'before/after' diff or a concrete 变更预算 entry — which would make the abstract rules copy-paste applicable; it is well above 3 since the steps are specific and ordered, not pseudocode. | 4 / 5 |
Workflow Clarity | The sequence is clear: apply the 决策阶梯, "在第一个满足请求的层级停止", write the 变更预算 before editing, then verify with "新鲜的定向测试、validator、哈希" — so the destructive/batch-operation validation cap does not apply (validation evidence is explicitly required and stale evidence rejected: "不要把 exit code 或旧产物单独当作成功证据"). It misses 5 only because the error-recovery loop (verify → fix → re-verify) is implied rather than an explicit step. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references — no references/, scripts/, or assets/ directories exist and the body cites none — and the guideline explicitly allows a 5 for such skills with well-organized sections. The six section headers are clear, non-nested, and each is scannable, so nothing is buried or inlined that belongs in a separate file. | 5 / 5 |
Total | 18 / 20 Passed |