ralph-loop SKILL.md skillA

ralph-loop from belumume/claude-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add belumume/claude-skills/ralph-loop@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
belumume/claude-skills
Path
ralph-loop/SKILL.md
Versions recorded
3
Latest version
v1.0.0, committed May 23, 2026
First version recorded
Jan 17, 2026
Size
7,816 bytes
Repository stars
46
License
none declared

Activate autonomous Ralph Wiggum loop mode for iterative task completion. Use when you have a well-defined task with clear completion criteria that benefits from persistent, autonomous execution.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Ralph Wiggum Loop Mode

Named after the Simpsons character who "never stops despite being confused," this technique runs Claude Code in a loop where the prompt stays the same but the codebase accumulates changes. Each iteration reads previous work and continues until completion.

## When to Use Ralph Mode

**Ideal for:**
- Well-defined implementation tasks with clear completion criteria
- Refactoring or migration work (e.g., React v16 to v19)
- Test-driven development cycles (run until tests pass)
- Batch processing or repetitive tasks
- Overnight autonomous work sessions

**Not ideal for:**
- Tasks requiring design decisions or human judgment
- Exploratory work without clear end states
- Tasks where requirements may change mid-execution
- First-time implementations where you need to learn the code

## Activation Protocol

### Step 1: Validate Task Suitability

Before activating, confirm:
- [ ] Task has clear, measurable completion criteria
- [ ] Success can be verified programmatically (tests, build, specific file state)
- [ ] The work is in a git-tracked directory
- [ ] You understand what success looks like

### Step 2: Create State File
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add belumume/claude-skills/ralph-loop@sha256:7a19d229656ee2d0

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_mouib2aflrt5k5dn.svg)](https://markdownregistry.com/a/art_mouib2aflrt5k5dn)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 3 versions of this file, between Jan 17, 2026 and May 23, 2026, about one every 63 days.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-05-23 4eda55c 7,816 BA view · diff
v1.0.02026-01-17 4e92ee6 7,794 BA view · diff
git:20260117.6ab80212026-01-17 6ab8021 7,699 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7816 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

belumume/claude-skills · 46 stars · license none declared · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mouib2aflrt5k5dn
GET https://markdownregistry.com/api/v1/resolve?ref=belumume/claude-skills/ralph-loop
GET https://markdownregistry.com/api/v1/blob/7a19d229656ee2d01626569280c71c83b329cef42a38ee767bcd43882f975e29

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from belumume/claude-skills

CLAUDE.md CLAUDE.md file
belumume/claude-skills · CLAUDE.md
git:20261103.4f851c1 · audit A · 46 stars
compaction-check SKILL.md skill
belumume/claude-skills · compaction-check/SKILL.md · Answer the operator's compaction question (can I /compact now, is everything compounded and non-stale, is anything…
v0.1.0 · audit A · 46 stars
deep-brainstorming SKILL.md skill
belumume/claude-skills · deep-brainstorming/SKILL.md · Use when brainstorming a product or feature where multiple valid technology choices exist and the wrong one is costly…
git:20260320.ecd16ef · audit A · 46 stars
document-quality-standards SKILL.md skill
belumume/claude-skills · document-quality-standards/SKILL.md · Use when creating or editing documents (DOCX, PDF, XLSX, PPTX) that need professional output. Adds visual verification…
v1.0.0 · audit A · 46 stars
docx-advanced-patterns SKILL.md skill
belumume/claude-skills · docx-advanced-patterns/SKILL.md · Advanced python-docx patterns for handling nested tables, complex cell structures, and content extraction beyond basic…
v1.0.0 · audit A · 46 stars
obsidian-vault-builder SKILL.md skill
belumume/claude-skills · obsidian-vault-builder/SKILL.md · Use when adding/editing/querying content in an existing Obsidian vault, configuring plugins, integrating Claude Code…
v0.2.0 · audit A · 46 stars
pdf-handling SKILL.md skill
belumume/claude-skills · plugins/pdf-guard/skills/pdf-handling/SKILL.md · Extract PDFs to text and images before reading
git:20260717.47a9254 · audit A · 46 stars
project-retrospective SKILL.md skill
belumume/claude-skills · project-retrospective/SKILL.md · Use when a project needs multi-session retrospective analysis: after milestones, before starting a new phase, when…
git:20260523.4eda55c · audit A · 46 stars
rtl-document-translation SKILL.md skill
belumume/claude-skills · rtl-document-translation/SKILL.md · Translate structured documents (DOCX) to RTL languages (Arabic, Hebrew, Urdu) while preserving exact formatting, table…
v1.0.0 · audit A · 46 stars
document-quality-standards SKILL.md skill
belumume/claude-skills · web-desktop-exports/document-quality-standards/SKILL.md · Use when creating or editing documents (DOCX, PDF, XLSX, PPTX) that need professional output. Adds visual verification…
git:20251214.72bf1cd · audit A · 46 stars
docx-advanced-patterns SKILL.md skill
belumume/claude-skills · web-desktop-exports/docx-advanced-patterns/SKILL.md · Advanced python-docx patterns for nested tables, complex cells, and content extraction beyond .text property…
git:20260717.47a9254 · audit A · 46 stars
docx-template-filling SKILL.md skill
belumume/claude-skills · web-desktop-exports/docx-template-filling/SKILL.md · Fill DOCX template forms preserving 100% original structure - logos, footers, styles, metadata. Zero-artifact…
git:20251125.5bcdc76 · audit A · 46 stars

Every file in belumume/claude-skills

Other files named ralph-loop

ralph-loop SKILL.md skill
cursor/plugins · ralph-loop/skills/ralph-loop/SKILL.md · Start a Ralph Loop for iterative self-referential development. Use when the user asks to run a ralph loop, start an…
git:20260211.e87eaec · audit A · 15,586 stars
ralph-loop SKILL.md skill
foryourhealth111-pixel/vibe-skills · bundled/skills/ralph-loop/SKILL.md · Codex-compatible Ralph loop runner with dual engines (compat local state loop + optional open-ralph-wiggum backend).
git:20260225.f07419f · audit A · 3,805 stars
ralph-loop SKILL.md skill
barbieri/local-openfinance · .agents/skills/ralph-loop/SKILL.md · Start a Ralph Loop for iterative self-referential development. Use when the user asks to run a ralph loop, start an…
git:20260909.1e5ab42 · audit A · 24 stars
ralph-loop SKILL.md skill
gastonchevarria/god-mode · plugins/god-mode-dev/skills/ralph-loop/SKILL.md · Runs autonomous task loops with disk state, backpressure and isolated contexts (Ralph Loop). Use only when asked to…
git:20261014.522e28a · audit A · 3 stars

Browse by kind, by grade A, or by owner.