ralph-loop
Execute an autonomous development loop that picks one task per iteration, implements it, verifies it, and commits the result — each iteration in a fresh context window. Use when user runs /ralph, mentions "ralph loop", "autonomous loop", "builder verifier", "run tasks automatically", "iterate on tasks", "develop autonomously", or wants an automated build-verify-commit cycle with task tracking.
npx skills add majiayu000/claude-skill-registry --skill ralph-loop-joaquimscosta-arkhe-claude-plugins --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 Loop Execution Protocol Autonomous development with fresh context per iteration and Hat-lite builder/verifier workflow. ## Quick Start ```bash # From project directory (after /create-prd) ./ralph.sh 20 # Run up to 20 iterations ./ralph.sh 5 # Quick test with 5 iterations ``` ## How It Works Each iteration runs in a **fresh context window**: ``` ┌─────────────────────────────────────────────────────┐ │ ITERATION (Fresh Context) │ ├─────────────────────────────────────────────────────┤ │ 1. ORIENT: Read activity.log + tasks.json + memories│ │ 2. BUILD: Pick ONE task, implement, verify │ │ 3. VERIFY: Review, update status, commit │ │ 4. LEARN: (Optional) Save insights to memories │ │ 5. DECIDE: All done? → RALPH_COMPLETE │ └─────────────────────────────────────────────────────┘ ``` ## Hat-Lite System | Role | When | Responsibility | |------|------|----------------| | **Builder** | ~65% of iteration | Implement ONE task | | **Verifier** | ~35% of iteration | Review, update, commit | ## Key Files | File | Purpose | |------|---------| | `.ralph/current-taskset/tasks.json` | Task state (source of truth) | | `.ralph/current-taskset/activity.log` | Iteration history | | `.ralph/curr
- Quick Start
- How It Works
- Hat-Lite System
- Key Files
- Task JSON Format
- Completion Signal
- Commands
- Workflow Details
- Examples
- Troubleshooting
From project directory (after /create-prd)
What does the ralph-loop skill do?
Execute an autonomous development loop that picks one task per iteration, implements it, verifies it, and commits the result — each iteration in a fresh context window. Use when user runs /ralph, mentions "ralph loop", "autonomous loop", "builder verifier", "run tasks automatically", "iterate on tasks", "develop autonomously", or wants an automated build-verify-commit cycle with task tracking.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill ralph-loop-joaquimscosta-arkhe-claude-plugins --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.