Content
56%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 well-organized and genuinely actionable — real commands, templates, checklists, and a sensible five-step workflow — but it is roughly three times longer than an orchestrator needs to be. Classification logic is repeated in four forms and the generator summaries duplicate the specialized skills they point to, with no use of reference files to shed any of it.
Suggestions
Collapse the four presentations of classification (routing table, classification questions, example lists, decision tree) into one — the decision tree plus one compact example row per type — cutting roughly 100 lines.
Trim each 'Generator Summaries' section to purpose + recommended iterations (3-4 lines), deferring structure and best-practice detail to the sibling generator skills themselves or a single references/generators.md file.
Merge 'Common Patterns' and 'Troubleshooting' into one short section, keeping only the max-iterations table and the four task-won't-complete fixes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 435-line body is noticeably verbose: task classification is presented four separate ways (routing table, classification questions, 20 example bullet lines, and a decision tree), and the four 'Generator Summaries' sections restate each sibling skill's purpose, structure, best practices, and iteration counts — content that belongs in those skills' own files. Not a 1 because it does not pad with concepts Claude already knows (no 'what is a loop' tutoring), but well above the lean threshold of 4-5. | 2 / 5 |
Actionability | Concrete, executable guidance dominates: the actual command "/ralph-wiggum:ralph-loop \"[generated prompt]\" --completion-promise \"[YOUR_PROMISE]\" --max-iterations [recommended]", a filled-in task template, an explicit classification output format, a max-iterations table, and input/output checklists. Minor gaps — the classification step's output is a template Claude must improvise around, and 'Guide you through required inputs' is high-level — keep it below fully copy-paste-ready coverage of the common cases. | 4 / 5 |
Workflow Clarity | Steps 1-5 are clearly sequenced with checkpoints: Step 2 forces an explicit classification confirmation (a feedback loop with the user), Step 4 is a review pass, and Input/Output checklists plus a Troubleshooting section (symptoms → causes → fixes) cover error recovery. Not a 5 because validation is advisory prose ('Verify requirements are complete') rather than explicit executable validation steps, and there is no verify-then-retry loop for the generated prompt itself. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are all absent), so everything — classification examples, per-generator structures, iteration tables, troubleshooting — is inlined in one 435-line SKILL.md. Section headers are clear (better than the 'minimal structure' of a 2), but substantial content that clearly belongs in one-level-deep reference files (e.g., per-generator detail, classification example banks) is inline, matching the anchor-3 pattern. | 3 / 5 |
Total | 13 / 20 Passed |