Content
66%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 body itself is an excellent piece of skill writing: lean, highly structured, with a clearly gated seven-step workflow, validation checkpoints, and a scrub/audit feedback loop. However, as bundled it is incomplete — the templates and analyst prompts it depends on for execution are absent, which breaks both navigation and executability for the core of the workflow.
Suggestions
Ship the missing bundle files: the body depends on 15 files under templates/ (case.md, report.md, issue.md, bundle-README.md) and prompts/ (analyst-common.md plus the seven analyst dimensions, scrub.md, scrub-audit.md, similar-session.md) — add them, or inline the minimal content each step actually needs.
Link references/redaction-policy.md from the body: the export step asks the partner for a redaction level and dispatches scrub prompts, but the policy file that presumably defines the levels is present in the bundle yet never referenced, leaving it undiscoverable.
Define report §7 and §9 inline (one line each, e.g. '§7: superpowers involvement — states involvement and stops') so the verdict and issue steps are actionable even before templates/report.md is added, since steps 4–6 key off those section numbers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative with no explanations of concepts Claude already knows — details like "One transcript line can be a megabyte" and "gh cannot attach files" are non-obvious and earn their tokens. It falls short of anchor 5 only because the bundle-gating and no-diagnosis rules are repeated across the workflow steps, Hard Rules, and Red Flags tables, which is minor trimmable redundancy. | 4 / 5 |
Actionability | The orchestration layer is concrete — verified absolute paths, `~/.superpowers/diagnosing-superpowers/<session-id>/`, named redaction levels, `zip -r` or `tar -czf`, "repeating both until the audit returns CLEAN" — but most executable detail (case/report/issue templates, all eleven analyst and scrub prompts) lives in files absent from the bundle, and report sections §7 and §9 are referenced without their defining template. This matches anchor 3's 'concrete guidance but incomplete; missing key details' rather than 4's 'minor gaps'. | 3 / 5 |
Workflow Clarity | Seven numbered steps with explicit conditional gates ("Steps 5–7 run only on their stated condition"), validation checkpoints ("Discard any returned finding without path:line", approval gates before archiving or filing), and a genuine feedback loop (scrub → audit → repeat until CLEAN). The workflow is read-only on session files, so the destructive-operation cap does not apply; this matches anchor 5. | 5 / 5 |
Progressive Disclosure | The four references that do exist (session-discovery, context-safety, github-issues, redaction-policy) are small and one level deep, but 15 of the 19 paths the body cites — all of `templates/` and all of `prompts/` — are missing from the bundle, and the existing `references/redaction-policy.md` is never linked from the body. Scored against the actual bundle per the guidelines, navigation to the core workflow materials is broken, which is below anchor 3's 'could be better organized' but above anchor 1 since what exists is well-signaled and flat. | 2 / 5 |
Total | 14 / 20 Passed |