ralph

Convert PRD markdown or plain text into Ralph's structured prd.json format.

2|1|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/richardwu/agent-skills --skill ralph-richardwu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/richardwu/agent-skills/tree/main/skills/ralph
Command: npx skills add https://github.com/richardwu/agent-skills --skill ralph-richardwu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts existing PRDs into Ralph's prd.json format to drive autonomous agent workflows.

Core Features & Use Cases

  • Converts markdown or plain-text PRDs into a structured prd.json with project, branchName, description, and userStories.
  • Generates sequential US IDs, acceptance criteria, and default fields for straightforward verification.
  • Enables reuse by converting PRDs to Ralph format for PRD-driven automation in development pipelines.

Quick Start

Place your PRD in the input location and run the Ralph PRD converter to produce prd.json in your Ralph directory.

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 a structured JSON format?

Converting a markdown PRD into a structured JSON format involves parsing plain text to generate a schema-compliant file with project details, branch names, and formatted user stories. This creates a type-checked structure for autonomous agent workflows.

Can I generate user stories with acceptance criteria from plain text?

Yes, generating user stories with acceptance criteria from plain text automatically creates sequential IDs, titles, descriptions, and default fields. This ensures your project requirements are properly formatted for verification and execution.

What is the best way to structure a PRD for autonomous agent execution?

Structuring a PRD for autonomous agent execution requires transforming it into a JSON file containing project, branchName, description, and a list of userStories. This structured format enables agents to read and process development tasks autonomously.

Does the prd.json format require specific fields for user stories?

Yes, the prd.json format requires user stories to include specific fields such as IDs, titles, descriptions, acceptanceCriteria, priority, passes, and notes. These fields ensure type-checked schema compatibility for autonomous workflows.

How do I set up a PRD for an automated development pipeline?

Setting up a PRD for an automated development pipeline requires converting your markdown or plain text document into a structured JSON format. This generates branch names and user stories that drive autonomous project management and execution.