ralph-init

Generates a canonical PRD and progress ledger for Ralph-loop execution.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/KYRIE66nb/codex-omx-public-config --skill ralph-init-kyrie66nb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-init
Source: https://github.com/KYRIE66nb/codex-omx-public-config/tree/main/home/.agents/skills/ralph-init
Command: npx skills add https://github.com/KYRIE66nb/codex-omx-public-config --skill ralph-init-kyrie66nb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams rapidly define a canonical Product Requirements Document (PRD) for Ralph-loop execution, aligning goals and acceptance criteria before starting work.

Core Features & Use Cases

  • Interactive requirements gathering: Elicit goals, constraints, and success criteria through structured prompts.
  • PRD generation: Produce a canonical .omx/plans/prd-{slug}.md with problem statements, goals, non-goals, acceptance criteria, constraints, and phases.
  • Progress ledger initialization: Set up a canonical progress log at .omx/state/{scope}/ralph-progress.json and ensure synchronization with active sessions.

Quick Start

Provide a project or feature description to generate a canonical PRD at .omx/plans/prd-{slug}.md.

Frequently Asked Questions about ralph-init

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

FAQPage Schema
How do I generate a PRD for structured project execution?

To generate a PRD for structured project execution, provide a project or feature description to elicit goals, constraints, and success criteria. The skill produces a canonical markdown file with problem statements, goals, non-goals, acceptance criteria, constraints, and phases.

What is a progress ledger and how does it track milestones?

A progress ledger is a canonical JSON log initialized at .omx/state/{scope}/ralph-progress.json to track milestones. It ensures synchronization with active sessions during phased planning and migrates legacy inputs if present.

Can I use this for requirements capture and prioritization on any project?

Yes, you can use this for requirements capture and prioritization on any project idea requiring structured planning. It applies interactive prompts to elicit goals and constraints, ensuring alignment before phased execution begins.

How do I set up phased planning with acceptance criteria?

You set up phased planning with acceptance criteria by providing a feature description for interactive requirements gathering. The skill then generates a canonical PRD document defining specific phases, non-goals, and constraints for your workflow.

Does this workflow migrate legacy project inputs?

Yes, this workflow migrates legacy project inputs when present. During PRD generation and progress ledger initialization, it automatically detects and migrates existing inputs into the canonical .omx directory structure.