Content
62%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 highly actionable with a clear, checkpoint-driven workflow, but it is noticeably verbose — the routing logic, commands, and generator lists are each repeated multiple times — and it is a monolithic single file where a lean SKILL.md pointing to reference files would serve better. trimming the duplication and splitting detail into references/ would lift both weak dimensions.
Suggestions
Collapse the Overview table, "How Tasks Are Classified" table, Classification Questions, and Decision Tree into a single routing section (one table plus one decision tree) — the same information currently appears four times.
Merge the duplicated ralph-loop command blocks (Step 5, "Integration with Ralph Loop", and the closing command list) into one place, and drop the closing "Specialized Generators" list that repeats the Overview table.
Move per-generator summaries, classification example lists, and the max-iterations tables into references/ files (e.g., references/generators.md, references/iterations.md), keeping SKILL.md as a lean routing overview with clearly signaled one-level-deep references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The task-routing logic is presented at least four times (the Overview table, the "How Tasks Are Classified" table, the Classification Questions, and the Decision Tree), the ralph-loop command appears three times (Step 5, "Integration with Ralph Loop", and the closing command list), and the generator inventory is duplicated at the top and bottom. This goes beyond "some unnecessary explanation" — several sections are padded duplicates of each other, matching the level-2 anchor. It avoids level 1 only because no section explains generic concepts Claude already knows. | 2 / 5 |
Actionability | Provides mostly executable guidance: a copy-paste-ready "/ralph-wiggum:ralph-loop \"[generated prompt]\" --completion-promise \"[YOUR_PROMISE]\" --max-iterations [recommended]" invocation, a concrete classification output template ("CLASSIFICATION: [Task Type] / REASONING / GENERATOR"), a task-description template, numeric iteration recommendations, and an explicit wrong-generator fix ("Use ralph-prompt-single-task (not multi-task) for: [task]"). Minor gaps remain since the actual prompt formats are delegated to the four sub-generator skills. | 4 / 5 |
Workflow Clarity | Steps 1-5 are clearly sequenced with explicit validation checkpoints ("Does this classification look correct?" in Step 2, the Step 4 review list, Input/Output checklists) and feedback loops for error recovery in Troubleshooting ("Scope too large → Split into smaller tasks", "Unclear criteria → Make success criteria more specific"). This matches the level-5 anchor: explicit validation steps, feedback loops, and checklists; no destructive or batch operations apply a cap. | 5 / 5 |
Progressive Disclosure | Section headers are clear, but the skill is a single 435-line file with no references/ bundle at all — content that clearly belongs in separate files (per-generator summaries, the five classification example lists, the iteration tables) is inlined. This matches the level-3 anchor ("content that should be separate is inline"); it avoids level 2 because structure is present and navigation within the file is easy, and falls short of level 4's "most content is appropriately placed" split. | 3 / 5 |
Total | 14 / 20 Passed |