ralph-init

Generate a canonical PRD and initialize a Ralph progress ledger.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill standardizes the creation of a Product Requirements Document (PRD) for Ralph-driven workflows, ensuring a canonical artifact and a durable progress ledger exist.

Core Features & Use Cases

  • Generate a canonical PRD at .omq/plans/prd-{slug}.md that captures the problem statement, goals and non-goals, acceptance criteria, technical constraints, and implementation phases.
  • Link the PRD to Ralph so that the /ralph workflow can use it as the completion criteria and guide iterative work.
  • Initialize and maintain a canonical progress ledger at .omq/state/{scope}/ralph-progress.json, preferring session scope when an active session exists.
  • Migrate legacy inputs from .omq/prd.json and .omq/progress.txt into canonical artifacts for continuity.

Quick Start

Provide a project description to initialize the PRD and Ralph progress ledger.

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 project management workflows?

To generate a PRD, provide a project description to initialize a canonical document capturing goals, acceptance criteria, and phases. This creates a structured markdown file at .omq/plans/prd-{slug}.md to guide your project management workflow.

How does a PRD link to state-tracking for iterative work?

A PRD links to state-tracking by serving as completion criteria for the /ralph workflow. It initializes a progress ledger at .omq/state/{scope}/ralph-progress.json, guiding iterative work and tracking project state across active sessions.

Can I migrate legacy requirements from prd.json and progress.txt?

Yes, you can migrate legacy inputs from .omq/prd.json and .omq/progress.txt. The skill automatically converts these legacy files into canonical artifacts, ensuring continuity without losing existing requirements or progress data during the migration.

What is the best way to initialize project planning with acceptance criteria?

The best way to initialize project planning is providing a project description to generate a canonical PRD. This document defines technical constraints, non-goals, and implementation phases, establishing clear acceptance criteria to standardize your planning workflow.

Do I need an active session to initialize a progress ledger?

No, an active session is not required. The progress ledger initializes at .omq/state/{scope}/ralph-progress.json, but the system prefers session scope when an active session exists, ensuring state-tracking aligns with your current working context.