Content
92%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 content is a model of an instruction-only skill: lean, exactly actionable (state-file template plus a filled example), with guardrails that preempt the one real risk (false promises to escape the loop, unbounded iteration). The only notable gap is that the stop hook that powers the loop is assumed to exist rather than configured, which caps actionability at 4. It scores strongly on all dimensions.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with zero padding: "Create the directory `.cursor/ralph/` if it doesn't exist, then write the state file at `.cursor/ralph/scratchpad.md` with this exact format" gives exact guidance with no explanation of concepts Claude already knows. Every section (Trigger, Workflow, Guardrails, Output) earns its tokens. | 5 / 5 |
Actionability | Guidance is mostly executable: exact file path, an exact state-file template, a filled-in example with YAML frontmatter, and typed parameters with defaults ("`max_iterations` (number, default 0 for unlimited)"). The one gap is that the stop hook driving the loop is assumed rather than set up — step 4 says it "automatically intercepts" each turn with no instruction on configuring it. | 4 / 5 |
Workflow Clarity | A clear 4-step sequence (gather params → write state file → confirm → hook re-feeds prompt) with an explicit safety checkpoint: "Always recommend setting `max_iterations` as a safety net." Per the rubric's simple-skill exception, this ~50-line single-purpose skill scores 5 with an unambiguous sequence and validation of the risky aspect (unbounded looping). | 5 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/ directories) and none are needed at this size. The body is cleanly sectioned (Trigger, Workflow, Guardrails, Output) with no content that belongs in a separate file, matching the rubric's exception for under-50-line skills with no need for external references. | 5 / 5 |
Total | 19 / 20 Passed |