Content
100%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 exemplary instruction-only extension skill: it delegates the core plan-writing process to the parent skill by name and adds only tightly scoped, fully executable additions (worktree recovery with validation/failure handling, chapter marking, terminal title, phase handoff). Structure, token efficiency, and actionability are all strong, and the inline comments capture genuinely non-obvious operational knowledge rather than padding.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with zero filler: every comment conveys a non-obvious gotcha Claude would not otherwise know (e.g. "spawn_task always forks off the default branch; there is no way to pin it", "Strip the leading `worktree ` token (not awk $2) so worktree paths containing spaces survive", "Never write into the throwaway spawn worktree — it is an orphan the user prunes separately"). No basic concepts are explained; it assumes Claude's competence throughout. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready guidance: a complete bash worktree-recovery block with variables, a concrete ticket regex (`[A-Z]+-[0-9]+`), an exact terminal-title escape sequence, exact invocation arguments (`--phase plan --next-phase lock-tests`), and the exact spawn title format `[<TICKET>] [MR#<N>] Lock Tests`. No pseudocode or vague direction anywhere. | 5 / 5 |
Workflow Clarity | The sequence is explicit and ordered (Step 0 worktree re-establishment → Before actions → delegated core → After handoff), with a hard validation checkpoint and feedback loop in the recovery block: verify branch (`on=$(git branch --show-current)` ... `echo "WORKTREE RECOVERY FAILED..."; exit 1`), plus a fallback path (reuse an existing checkout when `worktree add` fails). Conditional handling (skip Step 0 when invoked manually) is also stated. | 5 / 5 |
Progressive Disclosure | This is a short (~56-line), single-purpose extension skill with no bundle files (references/, scripts/, assets/ are absent) and no need for external references. Per the simple-skill guidance, its well-organized sections (Step 0 / Before / After) and clearly signaled one-level-deep skill references (`superpowers:writing-plans`, `devflow:phase-handoff`) fully satisfy the criterion; nothing that belongs elsewhere is inlined. | 5 / 5 |
Total | 20 / 20 Passed |