ralph-runner
Run long-running autonomous AI agents using PRD-based task scoping.
npx skills add majiayu000/claude-skill-registry --skill ralph-runner --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Ralph Wiggum Agent Runner Run autonomous coding agents that ship code while you sleep. ## When to Use - Multi-story feature implementation - Overnight autonomous coding - Batch processing of related tasks - When you want AI to work independently ## Quick Commands ```bash # Run with current PRD ./scripts/ralph/ralph.sh # Run with custom PRD ./scripts/ralph/ralph.sh scripts/ralph/my-feature.json # Watch progress tail -f scripts/ralph/progress.txt ``` ## How It Works 1. Agent reads PRD, picks highest priority incomplete story 2. Implements ONLY that one story 3. Runs build/lint to ensure CI stays green 4. Commits work, updates PRD, appends to progress.txt 5. Repeats until all stories pass or max iterations ## PRD Structure ```json { "stories": [ { "id": "STORY-001", "title": "User can do X", "priority": 1, "passes": false, "acceptance_criteria": ["..."], "files_to_modify": ["..."] } ] } ``` ## Stop Condition Agent emits `<promise>COMPLETE</promise>` when all stories pass. ## Files | File | Purpose | |------|---------| | `scripts/ralph/ralph.sh` | Runner script | | `scripts/ralph/prd.json` | Current PRD | | `scripts/ralph/progress.txt` | Progress log | ## Reference Files | Topic | Fi
- When to Use
- Quick Commands
- How It Works
- PRD Structure
- Stop Condition
- Files
- Reference Files
- Related Skills
Run with current PRD Run with custom PRD Watch progress tail -f scripts/ralph/progress.txt
What does the ralph-runner skill do?
Run long-running autonomous AI agents using PRD-based task scoping.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill ralph-runner --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.