ralph-init

Create scripts/ralph with ralph.sh and prompt.md for loop execution.

Updated Jan 9, 2026
One-click install
npx skills add https://github.com/vickaul-ai/ralph-claude --skill ralph-init
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-init
Source: https://github.com/vickaul-ai/ralph-claude/tree/main/skills/ralph-init
Command: npx skills add https://github.com/vickaul-ai/ralph-claude --skill ralph-init

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ralph is designed to run an autonomous agent loop within your project, but you must set up the runtime files first. This Skill creates scripts/ralph, places ralph.sh and prompt.md in that directory, and configures the project for loop execution.

Core Features & Use Cases

  • Initializes Ralph in the current project by creating scripts/ralph and populating it with the runner and prompt.
  • After completing PRD generation with /prd and conversion with /ralph, enables running the iterative loop via the created script.
  • Provides a straightforward setup that persists progress and PRD state across iterations.

Quick Start

mkdir -p scripts/ralph cp ~/Documents/Projects/ralph-claude/ralph.sh scripts/ralph/ cp ~/Documents/Projects/ralph-claude/prompt.md scripts/ralph/ chmod +x scripts/ralph/ralph.sh After initialization, run: ./scripts/ralph/ralph.sh 10

Frequently Asked Questions about ralph-init

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

FAQPage Schema
How do I set up Ralph to run autonomous loops in my project?

Ralph setup creates a scripts/ralph directory with ralph.sh and prompt.md files needed to execute autonomous loops. After generating a PRD with /prd and converting it with /ralph, run the initialized script to begin iterating.

What files does Ralph initialization create and where?

Ralph initialization creates the scripts/ralph directory and populates it with ralph.sh (the loop runner) and prompt.md (the prompt configuration). These files persist your PRD state across autonomous iterations.

Do I need a PRD before initializing Ralph?

Yes. Ralph initialization follows PRD generation with /prd and conversion with /ralph. The setup configures your project to run the iteration loop, but the PRD and conversion must happen first.

How do I execute the Ralph loop after setup?

After initialization, run ./scripts/ralph/ralph.sh with the number of iterations as an argument—for example, ./scripts/ralph/ralph.sh 10 runs ten autonomous loop cycles.

What's required to run Ralph in my project?

Ralph requires standard shell commands, the copied ralph.sh and prompt.md files in scripts/ralph, and a completed PRD. No external dependencies or special tools are needed beyond basic shell functionality.

Can I modify ralph.sh and prompt.md after initialization?

Yes. Once ralph.sh and prompt.md are in scripts/ralph, you can edit them to customize loop behavior and prompts. Changes persist across runs, allowing you to refine the autonomous loop workflow.