ralph

Generates test criteria and drives iterations until all functional tests pass.

31|1|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/ericzakariasson/cursor-ralph-wiggum --skill ralph-ericzakariasson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/ericzakariasson/cursor-ralph-wiggum/tree/main/.cursor/skills/ralph-wiggum
Command: npx skills add https://github.com/ericzakariasson/cursor-ralph-wiggum --skill ralph-ericzakariasson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Build features iteratively until all functional tests pass, reducing debugging cycles and accelerating delivery.

Core Features & Use Cases

  • Phase-driven workflow that guides requirements gathering, iterative development, and verification.
  • Automatic test generation and tracking via the .agent/tests.json artifact.
  • Hook-driven status updates and progress reporting to surface current iteration and results.

Quick Start

Describe the feature you want, and I will generate tests, run iterations, and converge on a passing build.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I automate iterative feature development until tests pass?

To automate iterative feature development, describe your desired feature to trigger automatic test generation and iterative build cycles that converge on a passing build. The agent generates test criteria, tracks results, and drives iterations until all functional tests pass.

What is an iterative build agent and how does it manage test cycles?

An iterative build agent automates feature development by generating test criteria and running iterations until functional tests pass. It manages test cycles by tracking progress in a .agent/tests.json artifact and using hook scripts for status updates during the build process.

Do I need a specific file structure to run automated iterative builds?

Yes, running automated iterative builds requires a .agent/tests.json file for tracking test iterations and a SKILL.md frontmatter containing a name and description. Optional hook scripts can also be used to manage status updates and progress reporting during development.

Can I use an automated build agent for workflows with deterministic tests?

Yes, an automated build agent applies directly to project workflows with deterministic tests. It generates test criteria, drives iterative development cycles, and updates the .agent/tests.json tracking system until all functional tests pass.

What's the best way to reduce debugging cycles during feature development?

The best way to reduce debugging cycles is automating iterative feature development with a build agent that generates tests and drives iterations until passing. This phase-driven workflow gathers requirements, develops iteratively, and verifies results automatically to accelerate delivery.