CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

70%Weight 40%Scale 1-5

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 follows good conventions: third-person voice, an explicit "Use when" trigger clause, and natural trigger phrases that match what users would say. Its main weakness is the vague "what" — "iterative self-referential development" doesn't convey the concrete mechanism (prompt re-fed via stop hook, agent sees its own prior work) that distinguishes this skill. It lands solidly above average but below the exemplar descriptions.

Suggestions

Replace the abstract phrase "iterative self-referential development" with a concrete mechanism statement, e.g. "Feed the same task prompt back each turn so the agent iterates on its own previous work until completion" — this raises specificity and completeness simultaneously.

Add a few natural trigger variations users might phrase differently, such as "keep looping on a task" or "loop until done", to broaden keyword coverage toward anchor 5.

Mention the safety-net parameter (max_iterations) in the description so users searching for bounded/limited iteration also match this skill.

DimensionReasoningScore

Specificity

"Start a Ralph Loop for iterative self-referential development" names the domain and one concrete action, but "self-referential development" is abstract and the loop's actual mechanics (stop-hook prompt re-feeding, state file) never surface. It sits at anchor 3 (1-2 concrete actions, not comprehensive) rather than 4, which expects several specific actions.

3 / 5

Completeness

Both are present: the "what" ("Start a Ralph Loop for iterative self-referential development") and an explicit "Use when" clause with concrete triggers. The "what" stays vague about what the loop actually does, so it doesn't clearly and explicitly answer both at anchor 5.

4 / 5

Trigger Term Quality

"run a ralph loop", "start an iterative loop", and "repeated autonomous iteration on a task until completion" are natural phrases a user would say, giving good keyword coverage. Missing common variations like "keep looping", "loop until done", or "autonomous loop", so not anchor 5.

4 / 5

Distinctiveness Conflict Risk

"Ralph loop" is a distinct niche term unlikely to trigger the wrong skill, and the trigger phrases are specific. Minor overlap risk remains with generic iteration/loop skills ("start an iterative loop", "repeated autonomous iteration"), keeping it below anchor 5.

4 / 5

Total

15

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

cursor/plugins

Path

ralph-loop/skills/ralph-loop/SKILL.md

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.