Content
81%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.
The SKILL.md body itself is exceptional — dense, actionable, with a fully gated seven-step workflow including an explicit scrub/audit feedback loop. The bundle as shipped undermines it: nearly every templates/ and prompts/ file the body depends on is missing, so progressive disclosure breaks down and several steps cannot actually be executed.
Suggestions
Ship the missing bundle files: templates/ (case.md, report.md, issue.md, bundle-README.md) and prompts/ (analyst-common.md, the seven dimension prompts, scrub.md, scrub-audit.md, similar-session.md), so every path referenced in the body resolves.
Reference references/redaction-policy.md from the body (or remove it) — it is currently an orphan file that the redaction workflow in step 6 never points to.
Add a short bundle map (one-line listing of templates/, prompts/, references/ contents) near the top or in the 工作流 section so the file structure is discoverable even before the missing files are restored.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient throughout: ~90 lines of dense instructions with zero concept explanations, no padding, and two compact tables (速查, 危险信号) that compress guidance instead of lengthening it. Every line instructs rather than describes — matches the anchor-5 example of a skill that assumes Claude's competence. | 5 / 5 |
Actionability | Concrete, executable guidance dominates: exact paths (~/.superpowers/diagnosing-superpowers/<session-id>/), named prompt files per dimension, explicit commands (zip -r / tar -czf), named redaction levels (skeleton/evidence/full), and precise conditions per step. Not 5 because steps 2, 3, 4, 6 and 7 depend on templates/ and prompts/ files that are absent from the bundle, so execution stalls at those points as shipped. | 4 / 5 |
Workflow Clarity | Seven numbered steps with explicit per-step conditions (第 5–7 步只在各自注明的条件下执行), explicit validation gates (丢弃没有 path:line 的发现; scrub → scrub-audit loop repeated until CLEAN; 核对被引用的内容实际能证明什么), approval gates before archiving or filing issues, and a dangerous-signals checklist that anticipates drift. This matches the anchor-5 feedback-loop pattern exactly. | 5 / 5 |
Progressive Disclosure | The body signals one-level-deep references cleanly, but scored against the actual bundle most navigation targets are broken: only references/ exists (4 files), while the ~14 referenced files under templates/ and prompts/ (case.md, report.md, issue.md, bundle-README.md, analyst-common.md, the seven dimension prompts, scrub.md, scrub-audit.md, similar-session.md) do not exist, and references/redaction-policy.md is present but never referenced from the body. The promised disclosure structure is largely absent, which is below anchor 3's 'references present but not clearly signaled'. | 2 / 5 |
Total | 16 / 20 Passed |