setup-ralph

Set up Ralph autonomous coding loop scaffolding with PRD-driven user stories.

3|3|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/twikus/claude-configuration --skill setup-ralph-twikus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-ralph
Source: https://github.com/twikus/claude-configuration/tree/main/claude-code-config/skills/ralph-loop
Command: npx skills add https://github.com/twikus/claude-configuration --skill setup-ralph-twikus

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) components.

What problem does it solve?

This skill provides a ready-to-use scaffold for the Ralph autonomous AI coding loop, enabling teams to initialize the loop structure in any project without manual setup steps.

Core Features & Use Cases

  • Creates the .claude/ralph directory structure in your project and prepares the run-time assets.
  • Generates and tracks PRD-driven user stories as prd.json, plus a progress log for iterative learning.
  • Supports interactive PRD brainstorming via the step-01 process and a PRD-to-stories workflow.
  • Provides clear run instructions and guards to ensure the user runs Ralph themselves (no automatic execution).

Quick Start

Run /setup-ralph -i to brainstorm PRD interactively, or /setup-ralph -f <feature-name> to set up a feature scaffold. After setup, run bun run .claude/ralph/ralph.sh -f <feature-name> to start Ralph. You can customize PRD.md and prd.json under .claude/ralph/tasks/<feature-name> before running Ralph.

Frequently Asked Questions about setup-ralph

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

FAQPage Schema
How do I set up an autonomous coding loop for feature development?

Setting up an autonomous coding loop involves creating a .claude/ralph directory structure and generating PRD-driven user stories as prd.json, providing a scaffold for iterative execution.

How do I generate user stories from a PRD for AI execution?

Generating user stories from a PRD uses an interactive brainstorming process via step-01, converting your product requirements into a tracked prd.json file for iterative AI execution.

Do I need jq installed to use the Ralph AI loop scaffolding?

Yes, you need jq installed to use the Ralph AI loop scaffolding, as it is a required dependency for processing the JSON data structures used in the PRD-driven workflow.

What is the best way to start an interactive PRD brainstorming session?

The best way to start interactive PRD brainstorming is running the setup command with the interactive flag, which guides you through the step-01 process to define your feature requirements.

Does the Ralph autonomous coding loop execute automatically after setup?

No, the Ralph autonomous coding loop does not execute automatically after setup; it provides explicit guards and run instructions to ensure the user initiates Ralph manually.