ralph-init

Generate prd.json and progress.txt files with user stories from task descriptions.

2|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/chanhee-kang/oh-my-gemini --skill ralph-init-chanhee-kang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-init
Source: https://github.com/chanhee-kang/oh-my-gemini/tree/main/skills/ralph-init
Command: npx skills add https://github.com/chanhee-kang/oh-my-gemini --skill ralph-init-chanhee-kang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of PRDs and progress tracking from a task description, enabling teams to quickly initiate Ralph-loop work without manual setup.

Core Features & Use Cases

  • PRD scaffolding: Generates prd.json and progress.txt templates with required fields like project, branchName, description, and userStories.
  • Story guidance: Provides structured user story formats with IDs, titles, acceptance criteria, and priority guidance.
  • Use Case: A product manager describes a feature, and the Skill outputs a ready-to-use PRD and a progressing plan for Ralph-loop.

Quick Start

Run the ralph-init skill with your task description to generate .omc/prd.json and .omc/progress.txt. After creation, review and execute the Ralph loop with /oh-my-gemini:ralph-loop.

Frequently Asked Questions about ralph-init

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

FAQPage Schema
How do I automate PRD creation from a task description?

Automating PRD creation from a task description is done by generating a structured prd.json file with required fields like project, branchName, and userStories. This process scaffolds the document instantly, eliminating manual setup for product managers.

How do I write user stories with verifiable acceptance criteria for PRDs?

Writing user stories with verifiable criteria involves structuring each story with an ID, title, priority, and specific checks like Typecheck passes and Tests pass. This enforces a standard PRD format ensuring all stories are testable and verifiable.

What is a Ralph loop workflow and how do I track its progress?

A Ralph loop workflow is an automated process for executing tasks based on a PRD, tracked using a progress.txt file. It requires a standard prd.json to function, enabling teams to monitor task completion and verifiable criteria throughout the development cycle.

Can I generate a PRD template with prioritized user stories automatically?

Yes, you can automatically generate a PRD template with prioritized user stories by providing a feature description. The output creates a ready-to-use prd.json that includes structured story formats with IDs, titles, acceptance criteria, and priority guidance.

Does PRD scaffolding work without manual setup for product managers?

PRD scaffolding works without manual setup by taking a task description and automatically outputting the required prd.json and progress.txt templates. This allows product managers to quickly initiate work without configuring document structures themselves.