ralph

Convert unstructured markdown or text PRDs into structured prd.json format.

Updated Jun 30, 2026
One-click install
npx skills add https://github.com/BAIZ1D/macbookM1_rice --skill ralph-baiz1d
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/BAIZ1D/macbookM1_rice/tree/main/agent/skills/ralph
Command: npx skills add https://github.com/BAIZ1D/macbookM1_rice --skill ralph-baiz1d

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Ralph autonomous agent system requires product requirement documents (PRDs) to be in a specific structured prd.json format, but most PRDs are written in unstructured markdown or plain text, making manual conversion time-consuming and prone to errors that break autonomous execution.

Core Features & Use Cases

  • Structured PRD Conversion: Parses existing markdown or text PRDs and automatically generates the valid prd.json format Ralph expects, with correct project metadata, branch naming, and user story structure.
  • Right-Sized Story Splitting: Automatically splits large, unworkable feature requests into small, single-iteration user stories that fit within Ralph's context window limit, preventing failed runs from oversized tasks.
  • Dependency Ordering & Validation: Enforces correct story execution order based on technical dependencies, adds mandatory verifiable acceptance criteria (including typecheck and browser verification for UI changes), and includes archiving logic for previous PRD runs to avoid data loss.
  • Use Case: If you have a PRD for adding a task status tracking feature to your app, this skill will convert it into 4 properly sized, ordered user stories with all required acceptance criteria ready for Ralph to execute autonomously.

Quick Start

Use the ralph skill to convert the attached task status feature PRD into a prd.json file formatted for Ralph autonomous execution.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I convert a markdown PRD into structured user stories for autonomous development?

This Skill converts markdown PRDs into the prd.json format required for autonomous agent execution by automatically splitting large features into single-iteration user stories with dependency ordering and verifiable acceptance criteria.

What is prd.json format and when do I need it for software workflows?

The prd.json format is a structured file containing project metadata, branch naming, and dependency-ordered user stories required by the Ralph autonomous agent system to execute autonomous code generation without manual intervention.

How do I split large product requirements into single-iteration user stories?

You split large product requirements by parsing them with this Skill, which automatically divides unworkable feature requests into small, single-iteration user stories that fit within autonomous agent context window limits to prevent failed runs.

Can I use plain text PRDs for autonomous code generation workflows?

Yes, plain text PRDs can be used for autonomous code generation workflows by converting them into the structured prd.json format, which enforces correct story execution order and adds mandatory verification criteria like typecheck passes and browser validation.

Why does autonomous development fail when PRDs are not properly structured?

Autonomous development fails when PRDs lack proper structure because oversized tasks exceed context window limits and missing dependency ordering or verification criteria like typecheck passes break autonomous execution, causing failed runs.

Does the prd conversion process include verification criteria for UI changes?

Yes, the prd conversion process includes mandatory verifiable acceptance criteria, specifically adding typecheck passes and browser validation requirements for UI changes to ensure autonomous code generation meets technical quality standards.