ralph-loop

Detect iterative task requests and route them to the Ralph command.

175|26|Updated Aug 14, 2025
One-click install
npx skills add https://github.com/jmagly/aiwg --skill ralph-loop-jmagly
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-loop
Source: https://github.com/jmagly/aiwg/tree/main/agentic/code/addons/ralph/skills/ralph-loop
Command: npx skills add https://github.com/jmagly/aiwg --skill ralph-loop-jmagly

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates repetitive tasks by detecting user requests for iterative execution and invoking the /ralph command to run tasks until a specified completion criterion is met.

Core Features & Use Cases

  • Iterative Task Execution: Automatically loops through tasks like fixing bugs, refactoring code, or improving test coverage until success.
  • Intelligent Inference: Infers completion criteria (e.g., "tests pass", "lint clean") when not explicitly provided.
  • Concurrency Management: Supports running multiple loops in parallel, with clear limits and status tracking.
  • Use Case: When a developer says "ralph this: fix all TypeScript errors", this skill will repeatedly run the necessary commands and checks until the errors are resolved, managing the process automatically.

Quick Start

Use the ralph-loop skill to fix all TypeScript errors until the build succeeds.

Frequently Asked Questions about ralph-loop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate iterative code tasks like fixing TypeScript errors until the build succeeds?

You can automate iterative code tasks by invoking a loop command that repeatedly runs necessary checks and fixes until a specified completion criterion, such as a succeeding build, is met.

Can I run multiple automated debugging loops in parallel without conflicts?

Yes, you can run multiple automated debugging loops in parallel. The system manages concurrency using registry tracking to monitor status and enforce clear limits across active processes.

How do I define completion criteria for automated refactoring workflows?

You can explicitly define completion criteria for automated refactoring workflows, or let the system infer them automatically based on common development checks like passing tests or clean linting.

What is the best way to stop an automated iterative task if it loops indefinitely?

To stop an automated iterative task, use the designated abort command. The system provides specific commands for both checking the real-time status of loops and aborting their execution.

Does iterative task automation work with context-based developer requests or only explicit definitions?

Iterative task automation works with both. It detects and initiates loops based on explicit task definitions as well as inferring requirements from context-based developer prompts.

Why does my automated code quality loop fail to terminate after resolving lint errors?

An automated code quality loop may fail to terminate if the inferred completion criteria do not match the actual linting output, requiring explicit task definitions to ensure successful execution.