Content
77%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 unusually disciplined instruction-only skill: a tightly written, well-gated workflow with real validation feedback loops, no filler, and strong anti-drift scaffolding. Its weakness is the bundle itself — the body's navigation points mostly at template and prompt files that are not present, and one bundled reference is orphaned, so progressive disclosure only works for the references/ files.
Suggestions
Ship the referenced templates/ and prompts/ files in the bundle (case.md, report.md, issue.md, bundle-README.md, analyst-common.md, the seven analyst prompts, scrub.md, scrub-audit.md, similar-session.md), or remove those references from the body.
Link references/redaction-policy.md from the body where redaction levels are defined (step 6), since it is bundled but currently unreachable from SKILL.md.
Give the similar-sessions step (step 7) a concrete command for listing candidates by mtime and size (e.g. an ls -lt or find -printf invocation) so it does not depend solely on the missing prompts/similar-session.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative with zero concept explanations and no padding — every section ('Workflow', 'Quick reference', 'Hard rules', 'Red Flags') carries operational content, and it assumes Claude's competence throughout. It falls short of the lean anchor at 5 because the intake-before-analysis rule is stated three times in 'Red Flags' rows after already appearing as a Hard rule ('Intake before analysis. Nothing in steps 2–7 starts until your partner has answered'), a repetition that could be trimmed. | 4 / 5 |
Actionability | Most steps are concretely executable: exact paths ('~/.superpowers/diagnosing-superpowers/<session-id>/'), exact files to dispatch ('prompts/analyst-common.md', the seven named dimension prompts), exact commands ('zip -r or tar -czf'), and exact redaction levels ('skeleton (no tool-result bodies), evidence (bodies only for cited events), full'). It is 4 rather than 5 because a few steps defer detail without a backing file in the bundle — 'list candidates by mtime and size', 'find marker line numbers', 'turn confirmed findings into a signature' give direction but no runnable command or definition. | 4 / 5 |
Workflow Clarity | The seven steps are numbered and sequenced with explicit conditional gates ('Steps 5–7 run only on their stated condition'), explicit output validation ('Discard any returned finding without path:line'), a genuine feedback loop ('dispatch prompts/scrub.md, then prompts/scrub-audit.md, repeating both until the audit returns CLEAN'), and approval checkpoints before risky outward actions ('No archive before your partner has seen the scrub log… No issue or comment before they approve the exact text'). This matches the top anchor: clear sequence, explicit validation, error-recovery loops. | 5 / 5 |
Progressive Disclosure | The design is right — an overview body with inline, well-signaled, one-level-deep references ('per references/session-discovery.md', 'Follow references/context-safety.md on every session file') — but scored against the actual bundle, 3 of the ~15 referenced paths exist (session-discovery.md, context-safety.md, github-issues.md) while all templates/ and prompts/ files referenced by the workflow (case.md, report.md, issue.md, bundle-README.md, analyst-common.md, the seven analyst prompts, scrub.md, scrub-audit.md, similar-session.md) are absent, and the bundled references/redaction-policy.md is never referenced from the body. Navigation is broken in both directions, which is more than the 'minor organization gaps' of the 4 anchor. | 3 / 5 |
Total | 16 / 20 Passed |