ralph

Converts Markdown or plain text PRDs into Ralph's prd.json format.

Updated Jan 7, 2026
One-click install
npx skills add https://github.com/MidwestGentleman/Cabinet-Designer --skill ralph-midwestgentleman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/MidwestGentleman/Cabinet-Designer/tree/main/scripts/ralph/skills/ralph
Command: npx skills add https://github.com/MidwestGentleman/Cabinet-Designer --skill ralph-midwestgentleman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert PRDs into Ralph's prd.json format so autonomous agents can execute requirements automatically.

Core Features & Use Cases

  • Transforms a PRD into a standardized prd.json structure containing fields like project, branchName, description, and userStories.
  • Supports conversion from Markdown PRDs or plain text PRDs into the required JSON schema.
  • Applies to product requirements documentation that needs to be operationalized in Ralph for automation.

Quick Start

Provide the PRD to the converter and run it to generate the 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 PRD to JSON for autonomous agent execution?

The prd.json format includes fields for project, branchName, description, and userStories. Each user story contains IDs, titles, descriptions, acceptanceCriteria, priority, passes, and notes to drive autonomous execution.

How do I transform Markdown PRDs into structured JSON for automation workflows?

The converter parses Markdown PRDs or plain text inputs and outputs a prd.json file containing project, branchName, description, and userStories with IDs, acceptanceCriteria, priority, passes, and notes.

Can I use plain text PRDs to generate a structured JSON schema for autonomous agents?

The converter accepts plain text inputs and parses them to produce a prd.json file containing project, branchName, description, and userStories with IDs, titles, descriptions, acceptanceCriteria, priority, passes, and notes.

What is the best way to operationalize product requirements documentation for automated execution?

Converting PRDs into a standardized prd.json format operationalizes product requirements documentation for automated execution by structuring content into fields like project, branchName, description, and userStories with acceptanceCriteria and priority.

Does the PRD to JSON conversion support acceptance criteria and priority fields?

The generated prd.json includes userStories containing IDs, titles, descriptions, acceptanceCriteria, priority, passes, and notes, ensuring acceptance criteria and priority fields are fully supported in the conversion.

Why does my PRD to JSON conversion require specific fields like branchName and userStories?

The output prd.json drives the Ralph autonomous agent system, which requires structured data fields including project, branchName, description, and userStories with IDs, acceptanceCriteria, priority, passes, and notes to execute requirements automatically.