Content
67%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 a well-structured, actionable process skill with a clear three-step workflow, explicit checkpoints, and appropriate single-file organization. Its main weakness is repetition — the stop-and-ask message and critical-review reminder each appear multiple times — which inflates token cost without adding guidance.
Suggestions
Consolidate the stop-and-ask guidance into the 'When to Stop and Ask for Help' section and remove the duplicated lines from 'Remember' and 'When to Revisit Earlier Steps'.
Trim the subagent/platform note to a single sentence (e.g. 'If subagents are available, prefer superpowers:subagent-driven-development instead.') and cut 'Review plan critically first' from Remember since Step 1 already mandates it.
Add one concrete recovery step for verification failure (e.g. what to check or retry once before stopping) so 'Run verifications as specified' has a complete feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient bullets, but the stop-and-ask guidance is repeated three times ('Ask for clarification rather than guessing', "Don't force through blockers - stop and ask", 'Stop when blocked, don't guess'), 'Review plan critically first' in Remember duplicates Step 1, and the platform note about Superpowers working 'much better with access to subagents' is padded — matching 'mostly efficient but could be tightened'. | 3 / 5 |
Actionability | For an instruction-only skill the guidance is concrete: verbatim announce strings, named sub-skills ('superpowers:finishing-a-development-branch', 'superpowers:using-git-worktrees'), explicit tool actions ('Create TodoWrite', 'Mark as in_progress'), and a specific stop-condition list. Minor gaps remain — 'Run verifications as specified' defers entirely to the plan without saying what to do on first failure. | 4 / 5 |
Workflow Clarity | The three-step sequence is clear with real checkpoints: a concern gate before starting ('If concerns: Raise them with your human partner before starting'), per-task verification ('Run verifications as specified'), explicit stop conditions, revisit conditions, and a Remember checklist. Error recovery escalates ('Verification fails repeatedly' → stop and ask) rather than giving a fix-and-retry loop, and completion is delegated to a sub-skill, leaving minor validation gaps. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), so everything lives appropriately in a single well-sectioned SKILL.md, with cross-skill references clearly signaled one level deep in the Integration section. The redundancy between 'When to Stop', 'When to Revisit', and 'Remember' is a minor organization gap keeping it below the top anchor. | 4 / 5 |
Total | 15 / 20 Passed |