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.
A dense, operational skill body with excellent workflow engineering: explicit sizing formula, copy-paste node prompts, structural validation with a repair feedback loop, and templates that double as the distributed writers' instructions. The two residual weaknesses are the Phase 1 sizing spec not being executable code and an inlined-everything structure that, while justified by the load_skills design, makes the file long and slightly repetitive.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is telegraphic and assumes Claude's competence throughout - no concept explanations, no library tutorials - with every section operational (formula, node prompts, templates, bash). Minor trimmable instances remain: the always-reduce rule is stated twice (the <critical> block and again in Anti-Patterns), and the committed-mode PR handoff prose runs long. Fits the efficient-with-minor-over-explanation anchor; not 5 given the ~330-line body and this repetition. | 4 / 5 |
Actionability | Highly executable: copy-paste-ready scanner/writer prompt templates, an exact bash snapshot script, a scoring matrix with concrete thresholds and weights, and decision rules. The main gap is Phase 1's sizing "eval cell", which is formula/spec notation ("S = total source bytes after exclusions") labeled as "code, not mental arithmetic" but with no command that actually computes S or per_dir - a spec rather than runnable code, so it falls just short of fully copy-paste ready. | 4 / 5 |
Workflow Clarity | Five phases are explicitly sequenced with a dedicated verify node emitting per-file PASS/FAIL verdicts and an amend-loop feedback cycle ("Loop until all PASS"), plus VERIFY/STOP-WHEN checklists embedded in every node prompt. The destructive --create-new path mandates reading all existing AGENTS.md files before deletion, so the batch/destructive validation cap does not apply. Matches the anchor for clear sequence, explicit validation, and error-recovery feedback loops. | 5 / 5 |
Progressive Disclosure | A well-sectioned single file with clear phase headers, and the one external reference (mass-ulw's references/planning.md for wave doctrine and the failure playbook) is clearly signaled and one level deep. All templates and the scoring matrix are inlined - justified by design since writer nodes load only this skill - but a ~330-line body keeping the full bash script, PR handoff, and templates inline keeps it at good-structure-with-minor-gaps rather than a clean overview-plus-references split. No bundle files ship with the skill. | 4 / 5 |
Total | 17 / 20 Passed |