ralph-init

Create structured PRD and progress log files for ralph-loop execution.

Updated Feb 20, 2026
One-click install
npx skills add https://github.com/ssccio/cc-on-web-base --skill ralph-init-ssccio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-init
Source: https://github.com/ssccio/cc-on-web-base/tree/main/skills/ralph-init
Command: npx skills add https://github.com/ssccio/cc-on-web-base --skill ralph-init-ssccio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the blank-page problem when starting a ralph-loop run by generating a clear, structured PRD and progress log from your task description.

Core Features & Use Cases

  • PRD initialization: Creates .omc/prd.json with a project, branch name, description, and right-sized user stories.
  • Progress logging: Generates .omc/progress.txt with an initial timestamp and a ready-to-fill progress structure.
  • Execution-ready guidance: Ensures user stories include verifiable acceptance criteria such as Typecheck passes and Tests pass, with prioritized ordering for foundational work.

Quick Start

Provide the feature idea or task details, and ask the AI to run ralph-init to generate the PRD and progress files for a ralph-loop execution.

Frequently Asked Questions about ralph-init

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

FAQPage Schema
How do I convert an ambiguous task description into structured user stories for iterative development?

To convert an ambiguous task into structured user stories, you can initialize ralph-loop execution artifacts by generating a structured PRD file with right-sized, independent, and verifiable user stories from your task details.

What is the best way to generate a Product Requirements Document with verifiable acceptance criteria?

Generating a PRD with verifiable acceptance criteria involves creating a structured file that decomposes your goal into prioritized user stories, ensuring checks like Typecheck passes and Tests pass are included for foundational work.

How do I initialize a progress log for iterative task completion?

To initialize a progress log for iterative task completion, you generate a text file with an initial timestamp and a ready-to-fill structure, tracking your progress alongside the structured PRD.

Can I use ralph-init for projects that need independent and verifiable user stories?

Yes, you can use ralph-init for projects requiring independent and verifiable user stories, as it specifically fits scenarios where you need to convert ambiguous goals into right-sized stories for iterative completion.

What files does ralph-init create when starting a ralph-loop run?

When starting a ralph-loop run, ralph-init creates a PRD file and an initial progress log, writing them as `.omc/prd.json` and `.omc/progress.txt` in the required formats for execution-ready guidance.