Content
96%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 tight, highly actionable workflow skill: concrete templates, a specific failure-pattern table, and an explicitly validated four-phase sequence. Its only real costs are redundancy between the recovery heuristics and the phase sections, and a monolithic single-file layout that could shed the templates to a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and free of concept explanations Claude already knows, but the 'Recovery Heuristics' section substantially restates Phase 2/3 guidance ('Verify the world state instead of trusting memory' duplicates 're-check the actual filesystem / branch / process state'; 'Shrink the failing scope' duplicates 'narrow the task to one failing command'), and the good/bad pattern section repeats it a third time. | 4 / 5 |
Actionability | Three copy-paste-ready markdown templates (failure capture, recovery action, self-debug report), a diagnosis table with concrete failure signatures (ECONNREFUSED, 429, file missing after write, tests still failing after 'fix'), and specific diagnosis questions make the guidance fully executable for an instruction-only skill. | 5 / 5 |
Workflow Clarity | The four-phase loop (Capture -> Diagnose -> Recover -> Report) is explicitly sequenced with validation checkpoints ('What evidence would prove the fix worked', 'Run one discriminating check') and feedback loops ('change the plan only if the check supports it', 'Only then retry'), plus a defined output standard. | 5 / 5 |
Progressive Disclosure | A single well-organized file with clear section headers and easy navigation, but at ~150 lines everything is inline; the pattern table and the three templates are sizable enough that a one-level-deep references/ split would fit the level-5 anchor, and no bundle files exist to offload them. | 4 / 5 |
Total | 18 / 20 Passed |