ralph

Convert PRD markdown into Ralph prd.json with user stories and acceptance criteria.

Updated Feb 2, 2026
One-click install
npx skills add https://github.com/CuriouslyCory/ralph-workshop --skill ralph-curiouslycory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/CuriouslyCory/ralph-workshop/tree/main/.claude/skills/ralph
Command: npx skills add https://github.com/CuriouslyCory/ralph-workshop --skill ralph-curiouslycory

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts PRDs into Ralph-ready prd.json to automate the translation from human-readable PRDs into a machine-friendly format for autonomous agents, reducing manual formatting errors and speeding up deployment.

Core Features & Use Cases

  • PRD to Ralph JSON conversion: Translates a markdown or text PRD into the Ralph prd.json schema with project, branchName, description, and userStories.
  • Structured outputs: Produces a deterministic prd.json that Ralph can ingest for autonomous execution.
  • Quick-start oriented: Guides users to provide a PRD and obtain a ready-to-run prd.json for Ralph.

Quick Start

Provide a PRD in markdown or text and run the Ralph PRD Converter to generate prd.json.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I convert a PRD into JSON for autonomous execution?

Converting a PRD into JSON involves mapping your markdown or text document into a structured prd.json schema, translating each requirement into individual user stories with verifiable acceptance criteria and a deterministic branch name for autonomous execution.

What is the Ralph prd.json schema structure?

The Ralph prd.json schema structure includes project, branchName, description, and userStories fields. Each PRD item is mapped into individual user stories containing verifiable acceptance criteria for autonomous agent execution.

How do I generate a deterministic branch name from a PRD document?

Generating a deterministic branch name from a PRD document is handled automatically during the JSON conversion process. The converter analyzes your PRD text and maps it into the prd.json schema, which includes calculating the deterministic branch name.

Can I use markdown text to create user stories with verifiable acceptance criteria?

Yes, you can use markdown text to create user stories with verifiable acceptance criteria. The conversion process maps each PRD item from your markdown document into individual user stories structured within the prd.json format for autonomous execution.

What are the limitations of converting PRDs into JSON format?

A limitation of converting PRDs into JSON format is that the input must be a PRD document or markdown text. The conversion requires mapping each PRD item into individual user stories, meaning unstructured or incomplete requirements may not translate correctly into the prd.json schema.