ralph

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

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/pbisogno/DreamCI --skill ralph-pbisogno
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/pbisogno/DreamCI/tree/main/.claude/skills/ralph
Command: npx skills add https://github.com/pbisogno/DreamCI --skill ralph-pbisogno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

PRDs written in Markdown or plain text often need to be transformed into Ralph's prd.json format so Ralph can autonomously execute the plan.

Core Features & Use Cases

  • Converts a PRD (Markdown or text) into the prd.json structure Ralph uses for autonomous tasks.
  • Outputs the resulting prd.json to scripts/ralph/prd.json with a branchName derived from the feature and a list of user stories ready for execution.
  • Validates that the PRD's title/intro provide enough context to populate project, description, and userStories fields.

Quick Start

Provide a PRD file in Markdown and the tool will generate scripts/ralph/prd.json ready for Ralph to run.

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 in Markdown into prd.json for autonomous execution?

To convert a Markdown PRD into prd.json, provide a file with YAML frontmatter containing name and description. The tool outputs a prd.json file under scripts/ralph/ with project, branchName, description, and one-to-one userStories mappings ready for execution.

What is the required format for a PRD to be converted into prd.json?

A PRD requires YAML frontmatter with name and description fields to convert into prd.json. The Markdown or text input must provide enough context to populate the project, description, and userStories fields in the output.

How does user story conversion work when generating prd.json from a PRD?

User story conversion creates a one-to-one mapping from the PRD input into the prd.json format. Each story is prepared for execution with standard acceptance criteria like go build, go vet, and make test.

Do I need YAML frontmatter to generate a prd.json file?

Yes, YAML frontmatter with name and description is required to generate a prd.json file. The conversion uses this metadata to validate and populate the project, branchName, and description fields.

Where is the output prd.json file saved during PRD conversion?

The output prd.json file is saved under scripts/ralph/prd.json. It includes a branchName derived from the feature and a list of user stories ready for autonomous execution.

What standard acceptance criteria are included in prd.json user stories?

Standard acceptance criteria included in prd.json user stories are go build, go vet, and make test. These criteria are automatically generated during the PRD conversion process.