ralph-loop
SKILL.md
Ralph Loop
Autonomous development loop that continues working until all tasks are complete.
Workflow
When triggered, execute this loop:
┌─────────────────────────────────────────────────────────┐
│ RALPH LOOP │
├─────────────────────────────────────────────────────────┤
│ 1. Check TodoWrite for pending tasks │
│ 2. If no pending tasks → output "COMPLETE" and exit │
│ 3. Pick highest priority pending task │
│ 4. Mark task as in_progress │
│ 5. Execute the task │
│ 6. Mark task as completed │
│ 7. Go to step 1 │
└─────────────────────────────────────────────────────────┘
Exit Condition
Output exactly COMPLETE (on its own line) when:
- All tasks in the todo list are marked as completed
- No more pending tasks remain
Execution Rules
- Task Priority: Process tasks in order (top to bottom)
- One at a Time: Only one task should be
in_progressat any moment - Immediate Update: Mark tasks completed immediately after finishing
- No Skipping: Complete each task fully before moving to the next
- Error Handling: If a task fails, log the error and continue to next task
Status Block
After each task completion, output a status block:
RALPH_STATUS:
completed: <task description>
remaining: <number of pending tasks>
EXIT_SIGNAL: <true if no more tasks, false otherwise>
Example
User: 全部完成
Claude: [Invokes ralph-loop skill]
Checking todo list...
- [x] Task 1 (completed)
- [-] Task 2 (in_progress) ← Working on this
- [ ] Task 3 (pending)
RALPH_STATUS:
completed: Task 2
remaining: 1
EXIT_SIGNAL: false
[Continues to Task 3...]
RALPH_STATUS:
completed: Task 3
remaining: 0
EXIT_SIGNAL: true
COMPLETE
Weekly Installs
9
Repository
xfstudio/skillsGitHub Stars
2
First Seen
Jan 27, 2026
Security Audits
Installed on
gemini-cli8
cursor8
trae7
antigravity7
claude-code7
kiro-cli7