Start a Ralph Loop for iterative self-referential development. Use when the user asks to run a ralph loop, start an iterative loop, or wants repeated autonomous iteration on a task until completion.
90
88%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description has strong trigger terms, explicit 'Use when' guidance, and a highly distinctive skill name that minimizes conflict risk. Its main weakness is that the actual capabilities are somewhat vague—'iterative self-referential development' and 'repeated autonomous iteration on a task until completion' don't clearly explain what concrete actions the skill performs or what outputs it produces.
Suggestions
Add specific concrete actions describing what happens during a Ralph Loop iteration (e.g., 'Executes a task, evaluates output, refines approach, and repeats until quality criteria are met').
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | It names the domain ('iterative self-referential development') and one action ('Start a Ralph Loop'), but doesn't list multiple concrete actions or explain what the loop actually does beyond vague 'iterative self-referential development' and 'repeated autonomous iteration on a task until completion'. | 2 / 3 |
Completeness | Clearly answers both 'what' (start a Ralph Loop for iterative self-referential development) and 'when' (explicit 'Use when' clause with multiple trigger scenarios: run a ralph loop, start an iterative loop, repeated autonomous iteration until completion). | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms: 'ralph loop', 'iterative loop', 'repeated autonomous iteration', 'until completion'. These cover the likely phrases a user would say when requesting this specific functionality. | 3 / 3 |
Distinctiveness Conflict Risk | The term 'Ralph Loop' is highly distinctive and unlikely to conflict with other skills. The specific naming convention creates a clear niche that wouldn't be confused with general iteration or looping constructs. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, concise skill that provides clear actionable instructions for setting up a Ralph loop. Its main weakness is the lack of validation/error-recovery steps for what is essentially an autonomous iterative process—there's no guidance on detecting or recovering from malformed state, failed iterations, or stop hook issues. The guardrails section is a nice touch for safety bounding.
Suggestions
Add a validation step after writing the scratchpad file (e.g., re-read and confirm the YAML parses correctly before proceeding)
Include brief error-recovery guidance for when the stop hook doesn't fire or the state file becomes corrupted mid-loop
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient. It doesn't explain what iterative loops are or how agents work—it assumes Claude's competence and every section serves a clear purpose. The YAML format example is necessary and not padded. | 3 / 3 |
Actionability | Provides a concrete file format with exact path (`.cursor/ralph/scratchpad.md`), exact YAML frontmatter structure, a worked example, and specific parameters with defaults. Claude knows exactly what to create and how. | 3 / 3 |
Workflow Clarity | Steps are clearly sequenced (gather params → create file → confirm → begin work), but there's no validation checkpoint after writing the scratchpad file, and no guidance on what to do if the stop hook doesn't fire or if the state file is malformed. For an iterative autonomous loop, error recovery guidance would be important. | 2 / 3 |
Progressive Disclosure | For a skill under 50 lines with no need for external references, the content is well-organized into clear sections (Trigger, Workflow, Guardrails, Output) that are easy to scan and navigate. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
7dd9fea
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.