CtrlK
BlogDocsLog inGet started
Tessl Logo

ralph-loop

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

Quality

88%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

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').

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
cursor/plugins
Reviewed

Table of Contents

Is this your skill?

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.