setup-ralph-loop SKILL.md skillA

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

Install it, pinned
mdr add chrislacey89/skills/setup-ralph-loop@git:20261105.01fdd6e

Pins git:20261105.01fdd6e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
chrislacey89/skills
Path
setup-ralph-loop/SKILL.md
Versions recorded
8
Latest version
git:20261105.01fdd6e, committed Nov 5, 2026
First version recorded
Apr 14, 2026
Size
12,219 bytes
Repository stars
4
License
MIT

Infrastructure skill for setting up Ralph loop scripts for Claude-driven AFK execution. Use when a repo wants a HITL-to-AFK runner around /execute with bounded iterations, GitHub-native durable state, and explicit feedback loops. Not a normal feature-delivery stage; it prepares the repo for safer 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

# Setup Ralph Loop

Create the local scripts and repo conventions needed to run Ralph safely.

## Invocation Position

This is an infrastructure skill, not a normal feature-delivery stage.

Use `/setup-ralph-loop` when a project wants to run `/execute` in a repeatable HITL-to-AFK loop.

**Auto-invocation:** `/execute` automatically invokes this skill when it detects multi-slice GitHub-issue work (PRD, big-batch appetite, or multiple user stories) and no `ralph-once.sh` or `ralph.sh` exists in the repo root. This means the skill may be entered without the user explicitly calling it — the detection and invocation happen as a prerequisite step inside `/execute`.

Do not use it as part of the default feature pipeline. It prepares the repo so later `/execute` execution can run under Ralph with bounded iterations, explicit feedback loops, and durable GitHub-backed state.

## What This Sets Up

- **`ralph-once.sh`** for one-iteration HITL Ralph
- **`ralph.sh`** for bounded AFK Ralph runs
- **Optional package.json scripts** for convenient invocation
- **Repo-local loop prompts** that tell Ralph to prefer the highest-risk unblocked slice, run feedback loops, and stop when work is done
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add chrislacey89/skills/setup-ralph-loop@sha256:1fb9b22b9ba85814

The line at the top of this page pins the label git:20261105.01fdd6e, 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_n6lvjeryzs2nheef.svg)](https://markdownregistry.com/a/art_n6lvjeryzs2nheef)

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

Versions

The registry has recorded 8 versions of this file, between Apr 14, 2026 and Nov 5, 2026, about one every 29 days.

versioncommittedcommitsizeaudit
git:20261105.01fdd6e latest2026-11-05 01fdd6e 12,219 BA view · diff
git:20261030.b6b44682026-10-30 b6b4468 12,213 BA view · diff
git:20261030.f84cc012026-10-30 f84cc01 11,446 BA view · diff
git:20260812.b7ee27c2026-08-12 b7ee27c 11,195 BA view · diff
git:20260807.df7306c2026-08-07 df7306c 11,068 BA view · diff
git:20260804.acdad8f2026-08-04 acdad8f 10,200 BA view · diff
git:20260424.de3ec9f2026-04-24 de3ec9f 7,886 BA view · diff
git:20260414.0a69e392026-04-14 0a69e39 7,842 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 (12219 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

chrislacey89/skills · 4 stars · license MIT · pushed 2026-11-06 · branch prod

API

GET https://markdownregistry.com/api/v1/artifacts/art_n6lvjeryzs2nheef
GET https://markdownregistry.com/api/v1/resolve?ref=chrislacey89/skills/setup-ralph-loop
GET https://markdownregistry.com/api/v1/blob/1fb9b22b9ba85814a8a8a7a3e48ae0e8b937e5dbecfebc6e7711c996a9fc02b0

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 chrislacey89/skills

CLAUDE.md CLAUDE.md file
chrislacey89/skills · CLAUDE.md
git:20261106.e899164 · audit A · 4 stars
api-design-review SKILL.md skill
chrislacey89/skills · api-design-review/SKILL.md · Invoked helper skill for higher-risk API contract decisions, usually called from /research or /write-a-prd. Use when…
git:20260407.d6d717b · audit A · 4 stars
closeout SKILL.md skill
chrislacey89/skills · closeout/SKILL.md · Primary pipeline tail step after /pre-merge, when a reviewed PR is ready to land and you want the workspace back to a…
git:20261105.863eae4 · audit A · 4 stars
compound SKILL.md skill
chrislacey89/skills · compound/SKILL.md · Primary pipeline knowledge-capture step that closes the compounding loop. Capture a durable lesson in docs/solutions/…
git:20261105.863eae4 · audit A · 4 stars
correct-course SKILL.md skill
chrislacey89/skills · correct-course/SKILL.md · Side-route skill for explicit backtracking when an upstream artifact becomes untrustworthy. Use when research, PRD, or…
git:20261029.1549c2c · audit A · 4 stars
create-milestone SKILL.md skill
chrislacey89/skills · create-milestone/SKILL.md · Primary planning branch after /shape for major-tranche work that requires multiple independent PRDs. Use to create a…
git:20261021.d548445 · audit A · 4 stars
design-an-interface SKILL.md skill
chrislacey89/skills · design-an-interface/SKILL.md · Invoked helper skill for unresolved module boundaries, usually called from /write-a-prd. Use to compare multiple…
git:20260408.27121d1 · audit A · 4 stars
excavate SKILL.md skill
chrislacey89/skills · excavate/SKILL.md · User-invoked side-route for onboarding to a legacy repo with no docs/solutions/, research archive, or written…
git:20261105.01fdd6e · audit A · 4 stars
execute SKILL.md skill
chrislacey89/skills · execute/SKILL.md · Primary pipeline execution step after /prd-to-issues or for clearly scoped implementation work. Use to build, verify…
git:20261106.4cf0576 · audit B · 4 stars
fix-findings SKILL.md skill
chrislacey89/skills · fix-findings/SKILL.md · Invoked helper skill for fixing the review findings a human has already chosen (from a /pre-merge review, or teammate…
git:20261105.c15b677 · audit A · 4 stars
git-guardrails-claude-code SKILL.md skill
chrislacey89/skills · git-guardrails-claude-code/SKILL.md · Infrastructure safety skill for blocking dangerous git commands in Claude-driven workflows. Use when the repo or user…
git:20261025.18d51e4 · audit A · 4 stars
hackathon SKILL.md skill
chrislacey89/skills · hackathon/SKILL.md · User-invoked side-route for a judged, time-boxed hackathon day: turns the event brief into a scored project choice, an…
git:20261106.e899164 · audit A · 4 stars

Every file in chrislacey89/skills

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