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 body is an exceptionally actionable, well-gated workflow with a copy-paste-ready dispatch prompt and explicit validation checkpoints. Its main cost is token weight: the anecdotal justifications, while valuable, are written at narrative length and could be tightened substantially.
Suggestions
Compress the five war stories (vite minify, sourcemap, GDPR batch, six-apps issue, double-written build dir) into one-line parenthetical evidence after the check they justify — e.g. 'cite the reader, or the value ships as a no-op (a plan once set `minify: true` and the framework hard-overrode it)'.
Move the 13-line attacker prompt template and the Step 1 checklist heuristics into a `references/` file (e.g. `attacker-prompt.md`), keeping SKILL.md as the overview plus dispatch protocol — this would also raise the progressive-disclosure score.
Trim Step 0's narrative framing ('When in doubt it runs. The stage costs one round trip; the failure it catches costs the branch') to a single directive sentence; the reasoning is already implied by the never-skip list.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The prose assumes Claude's competence (no basic concepts explained) and there is no padding, but it carries five multi-line war stories (the vite `minify` no-op, the published `sourcemap`, the GDPR erasure batch, the six-apps issue premise, the two-process build measurement), each of which could be compressed to a clause while keeping its evidentiary value. This is 'mostly efficient but could be tightened' rather than 'efficient with minor trims', since the anecdotes together occupy a substantial fraction of the body. | 3 / 5 |
Actionability | The attacker prompt is given verbatim and copy-paste ready ("Read `<plan path>`. Attack it... Write `<findings path>` and reply with the path only"), with concrete paths (`.claude/agents/attacker.md`, `PLAN-REVIEW.md`, `docs/superpowers/plans/`, `tools/pr-metrics/index.ts`, `resolveDispatchBranch`), an explicit `TASK-BRANCH:` dispatch protocol, and enumerated skip/never-skip criteria. As an instruction-only skill its guidance is fully executable and covers the common cases. | 5 / 5 |
Workflow Clarity | Steps 0–4 are clearly sequenced with explicit validation gates ("No implementation starts while a finding is open. Silence is not a rejection."), a hard three-outcome enumeration for each finding (fix / reject in writing / escalate), evidence-based rejection checking ("Check the claim's numbers against the artefact"), and explicit re-run criteria. Error-recovery feedback loops are present throughout, matching the top anchor. | 5 / 5 |
Progressive Disclosure | No bundle directories exist, and the body's structure is clear with well-labeled sections and concrete pointers to real repo artefacts (`.claude/agents/attacker.md`, `tools/pr-metrics/index.ts`). It is not a 5 because at ~140 lines with an inline 13-line attacker prompt and detailed check heuristics, some material could live in a reference file; the >50-line simple-skill exception does not apply. | 4 / 5 |
Total | 17 / 20 Passed |