Can I preview what Ralph Runner will do before it starts?

Yes, you can use the --dry-run flag to preview the execution plan without actually invoking the AI or making changes to your codebase.

Is Ralph Runner suitable for large, complex features?

It is most effective when features are broken down into small, granular user stories that can each be completed within a single AI context window.

Does Ralph Runner require additional software?

Yes, this skill requires both the Claude Code CLI and the ralph-cli to be installed and configured on your local system.

What is Ralph Runner used for?

Ralph Runner is used to automate the implementation of software features by running Claude Code in iterative, autonomous loops guided by a Product Requirements Document (PRD).

How does Ralph Runner maintain project context across iterations?

It maintains state through the prd.json file, a progress.txt file that tracks learnings, and the project's own Git history which records every successful iteration.

Ralph Runner

Name: Ralph Runner
Author: linuxlewis

bylinuxlewis

•

Productivity & Workflow

Executes autonomous AI coding loops to implement features and user stories directly from a Product Requirements Document (PRD).

Ralph Runner is an orchestration skill designed to turn Claude Code into a fully autonomous development agent. By consuming a structured PRD file, it breaks down complex projects into iterative tasks, spawning fresh Claude instances to implement features one story at a time. It handles the full development lifecycle—from code generation and quality checks to Git commits and progress tracking—allowing developers to delegate the implementation of well-defined specifications while maintaining a persistent record of learnings and state transitions.

Key Features

01Live progress monitoring with a dedicated status dashboard

02Persistent progress tracking via Git history and a dedicated progress.txt log

031 GitHub stars

04Automatic quality assurance including linting, type-checking, and test execution

05Configurable iteration limits and multi-file context injection

06Autonomous iterative execution of user stories from a JSON-based PRD

Use Cases

01Automating the migration of a task list or backlog into functional, tested code

02Running unattended coding loops for repetitive implementation tasks and boilerplate

03Implementing a full set of features from a newly drafted Product Requirements Document

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add linuxlewis/agent-skills ralph-runner

For use in Claude.ai and ChatGPT

Download Skill