---

name: ralph-loop description: Detect requests for iterative AI task loops and invoke the Ralph command version: 1.0.0 triggers:

• "ralph this"
• "ralph:"
• "ralph it"
• "keep trying until"
• "loop until"
• "iterate until"
• "run until passes"
• "fix until green"
• "keep fixing until"
• "keep going until"
• "iterate on"

---

Ralph Loop Skill

You detect when users want iterative task execution and route to the /ralph command.

Trigger Patterns

Extraction Logic

Task Extraction

From explicit task:

• "ralph this: fix all TypeScript errors" → Task: "fix all TypeScript errors"
• "ralph: migrate src/ to ESM" → Task: "migrate src/ to ESM"

From context:

• "ralph it" after discussing a refactor → Use previous conversation as task context

Completion Inference

When user doesn't specify explicit verification:

Examples

User: "ralph this: migrate all files in lib/ to ESM" Extraction:

• Task: "migrate all files in lib/ to ESM"
• Completion (inferred): "node --experimental-vm-modules lib/index.js runs without errors"

Action: Invoke /ralph "migrate all files in lib/ to ESM" --completion "node --experimental-vm-modules lib/index.js succeeds"

---

User: "keep fixing until the tests are green" Extraction:

• Task: "fix failing tests" (from context or implied)
• Completion: "npm test passes with 0 failures"

Action: Invoke /ralph "fix failing tests" --completion "npm test passes"

---

User: "ralph it" (after discussing adding auth validation) Extraction:

• Task: (from conversation context about auth validation)
• Completion: (infer based on task type)

Action: Invoke /ralph "{context-based task}" --completion "{inferred criteria}"

---

User: "loop until coverage is above 80%" Extraction:

• Task: "add tests to improve coverage"
• Completion: "npm run coverage shows >80%"

Action: Invoke /ralph "add tests to improve coverage" --completion "coverage report shows >80%"

Clarification Prompts

If extraction is ambiguous, ask the user:

CopyI'll start a Ralph loop for: {extracted task}

What command verifies completion?
1. npm test (Recommended for test fixes)
2. npx tsc --noEmit (For type errors)
3. npm run lint (For lint errors)
4. npm run build (For build issues)
5. Custom command...

Or if task is unclear:

CopyI detected a Ralph loop request. To start iterating:

What task should I repeat until success?
What command tells me when it's done?

Invocation

Once task and completion are extracted/confirmed:

Copy/ralph "{task}" --completion "{completion}"

With optional parameters if the user specified them:

• --max-iterations N if user mentioned iteration limit
• --timeout M if user mentioned time limit
• --interactive if task needs clarification

Integration Notes

• This skill has high priority - ralph-related phrases should route here
• The skill is exclusive - once triggered, handle the entire request
• Always confirm extraction before invoking if there's ambiguity
• Prefer inferring completion criteria over asking (ask only if truly unclear)

Related

• /ralph command - the actual loop executor
• /ralph-status - check loop progress
• /ralph-resume - continue interrupted loops