Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is well-structured, actionable, and clearly sequenced for a single-purpose help skill. The only weakness is mild redundancy between the two iteration explanations, which affects conciseness.
Suggestions
Collapse the 'Each iteration' (6-step) and 'How it works' (5-step) lists into a single explanation to remove the overlap and tighten token use.
Consider noting where the state file (.cursor/ralph/scratchpad.md) lives only once rather than restating the stop-hook mechanism twice.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and free of concepts Claude already knows, but the six-step 'Each iteration' list and the five-step 'How it works' list under 'Starting a Ralph Loop' overlap substantially, which could be tightened. | 2 / 3 |
Actionability | Concrete, copy-paste-ready guidance is given: a startup command with flags ('--max-iterations', '--completion-promise'), the '<promise>TASK COMPLETE</promise>' tag, and a cancel instruction, matching the level-3 anchor. | 3 / 3 |
Workflow Clarity | The loop lifecycle (start, iterate, detect promise or hit max, cancel) is clearly sequenced; as an explanatory skill with no destructive batch operation, the simple-skill allowance applies and the single flow is unambiguous. | 3 / 3 |
Progressive Disclosure | A single, well-organized file with clearly labeled sections (What is, Starting, Cancelling, Completion Promises, When to Use, Learn More) and no nested references; no bundle files are needed or provided. | 3 / 3 |
Total | 11 / 12 Passed |