Content
88%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 exemplary instruction-only skill: verbatim templates, exact commands with expected outputs, a concrete self-review checklist with feedback loops, and explicit anti-placeholder rules, all delivered tersely. The only weaknesses are a small amount of recap redundancy and the absence of any progressive-disclosure structure in a 145-line single file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive — no basic-concept explanations (TDD, commits, and file granularity are stated as rules, not taught), and every section issues instructions. It falls short of 5 only through minor redundancy: the 'Remember' section recapitulates the Overview and 'No Placeholders' sections, and 'Bite-Sized Task Granularity' partially repeats the Task Structure template it precedes. | 4 / 5 |
Actionability | Fully concrete guidance throughout: a verbatim plan-header template, a complete task template with exact pytest commands and expected FAIL/PASS output, exact git add/commit commands, an exact save path pattern ('docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md'), an explicit forbidden-placeholder list, and a word-for-word execution-handoff script. As an instruction-only skill this is copy-paste actionable with no material gaps. | 5 / 5 |
Workflow Clarity | The process is clearly sequenced with temporal markers ('Before defining tasks...', 'After writing the complete plan...', 'After saving the plan...') running announce → scope check → file structure → tasks → self-review → save → handoff. Validation is explicit: a three-item self-review checklist (spec coverage, placeholder scan, type consistency) with fix-forward feedback loops ('If you find a spec requirement with no task, add the task'), plus verify-fail/verify-pass checkpoints embedded in the task template itself. Not a destructive/batch skill, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | A single-file skill (no references/, scripts/, or assets/ exist) with clean, well-labeled sections and nothing buried. It exceeds the under-50-line simple-skill threshold (~145 lines) and keeps everything inline with no overview-to-details split, so it does not earn the top anchor; not lower than 4 because nothing here obviously belongs in a separate file and navigation is unambiguous. | 4 / 5 |
Total | 18 / 20 Passed |