ralph-init

Converts project descriptions into a structured requirements document with progress ledger.

6|1|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/Goblin1024/oh-my-kimi --skill ralph-init-goblin1024
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-init
Source: https://github.com/Goblin1024/oh-my-kimi/tree/main/skills/ralph-init
Command: npx skills add https://github.com/Goblin1024/oh-my-kimi --skill ralph-init-goblin1024

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ralph Init helps teams formalize product goals by creating a canonical PRD that guides Ralph-loop execution, reducing ambiguity and iteration waste.

Core Features & Use Cases

  • Gather requirements via interactive interview or from the provided description
  • Create PRD at .omk/plans/prd-{slug}.md with:
    • Problem statement
    • Goals and non-goals
    • Acceptance criteria (testable)
    • Technical constraints
    • Implementation phases
  • Link to Ralph so that /ralph can use the PRD as its completion criteria
  • Initialize/ensure canonical progress ledger at .omk/state/{scope}/ralph-progress.json (session scope if active session exists)

Quick Start

Provide a project or feature description to /ralph-init to generate the PRD and wire Ralph to the canonical plan.

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 structured PRD from a project description?

To generate a structured PRD, provide a project or feature description to initiate an interactive interview or direct conversion. The tool outputs a canonical requirements document with problem statements, goals, and acceptance criteria.

How does a canonical PRD reduce iteration waste in product planning?

A canonical PRD reduces planning waste by formalizing product goals and testable acceptance criteria upfront. This single structured document guides execution loops, removing ambiguity and preventing scope drift during development.

Can I create a PRD through an interactive interview instead of writing it manually?

Yes, you can create a PRD through an interactive interview process. The tool gathers your project requirements conversationally and converts them into a structured requirements document without needing manual formatting.

What is the best way to structure product requirements for iterative development?

The best way to structure requirements for iterative development is using a canonical PRD format. This includes defining problem statements, goals, non-goals, technical constraints, and phased implementation steps as completion criteria.

How do I track progress against a defined product plan?

You can track progress against a product plan using a canonical progress ledger. Initializing the PRD automatically creates a JSON ledger file to monitor goal-driven iterations and execution status throughout the session.

Do I need an active session to initialize the progress ledger for my workflow?

No, an active session is not strictly required as the tool ensures backward compatibility for legacy inputs. However, if an active session exists, the progress ledger is initialized directly within that specific session scope.