ralph

Convert PRD markdown files into Ralph's prd.json format.

2|1|Updated Jun 21, 2025
One-click install
npx skills add https://github.com/MeechYourGoals/Chravel --skill ralph-meechyourgoals
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/MeechYourGoals/Chravel/tree/main/.claude/plugins/chravel/skills/ralph
Command: npx skills add https://github.com/MeechYourGoals/Chravel --skill ralph-meechyourgoals

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the conversion of Product Requirements Document (PRD) markdown files into the structured prd.json format required by the Ralph autonomous agent, streamlining the setup for AI-driven development tasks.

Core Features & Use Cases

  • PRD to JSON Conversion: Transforms human-readable PRD markdown into machine-readable JSON.
  • Automated File Generation: Creates prd.json and progress.txt files for Ralph.
  • Use Case: After writing a new feature's PRD in markdown, use this skill to prepare it for Ralph by converting it into the necessary JSON format, including defining user stories, acceptance criteria, and branch naming conventions.

Quick Start

Use the ralph skill to convert the PRD document located at tasks/prd-user-authentication.md into prd.json format.

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 markdown file to JSON format for autonomous agents?

To convert a PRD markdown file to JSON format for autonomous agents, this skill parses markdown and maps features, user stories, and acceptance criteria into Ralph's structured prd.json schema for AI-driven execution.

What is the process for transforming product requirements into machine-readable JSON?

Transforming product requirements into machine-readable JSON involves parsing markdown files to extract structured data like features and acceptance criteria. This skill applies specific JSON schema and markdown parsing rules to generate the prd.json file.

How do I set up a PRD for Ralph autonomous agent execution?

To set up a PRD for Ralph autonomous agent execution, convert your markdown document into the required prd.json format. This skill generates prd.json and progress.txt files, defining branch naming conventions and user stories for the agent.

Do I need a specific markdown structure to convert PRDs to prd.json?

Yes, converting PRDs to prd.json requires adherence to specific JSON schema and markdown parsing rules. Your markdown must clearly define features, user stories, and acceptance criteria to ensure accurate transformation into the structured JSON format.

What is the best way to define user stories and acceptance criteria in a prd.json file?

The best way to define user stories and acceptance criteria in a prd.json file is by structuring them in your source markdown PRD and using an automated conversion tool. This skill extracts these elements and formats them according to Ralph's JSON schema.

Can I automate the generation of prd.json and progress.txt files from markdown?

Yes, you can automate the generation of prd.json and progress.txt files from markdown. This skill handles the automated file generation required by the Ralph autonomous agent, streamlining the setup for AI-driven development tasks.