ralph

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts existing PRDs into Ralph's prd.json format so you can drive autonomous task execution with Ralph.

Core Features & Use Cases

  • PRD to prd.json conversion: Transform Markdown or text PRDs into a Ralph-compatible JSON structure.
  • Branching and summary generation: Generate a Ralph branchName and a concise description from the PRD, plus structured user stories ready for iteration.
  • One-iteration readiness: Outputs are designed to be completed within a single Ralph iteration with machine-verifiable criteria.

Quick Start

Provide a PRD file or paste PRD text; the skill will output a prd.json in your ralph directory ready for activation.

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 JSON format for autonomous execution?

To convert a markdown PRD into JSON for autonomous execution, provide the PRD file or text to generate a structured prd.json containing the project name, branch name, description, and machine-verifiable user stories.

What is a prd.json file and when do I need it for product management?

A prd.json file is a structured JSON format representing product requirements that enables autonomous execution by the Ralph agent. You need it when transforming markdown PRDs into machine-verifiable user stories for single-iteration task completion.

Can I use plain text PRDs to generate structured user stories and branch names?

Yes, you can use plain text PRDs to generate structured user stories and branch names. The conversion process accepts plain text inputs and outputs a valid prd.json containing the project description and machine-verifiable stories.

What is the best way to structure product requirements for a single autonomous iteration?

The best way to structure product requirements for a single autonomous iteration is to enforce a one-PRD-per-output rule, generating a prd.json with project details and machine-verifiable user stories designed to be completed within one execution cycle.

Why does my PRD conversion output only contain one project in the prd.json?

Your PRD conversion output contains only one project because the system enforces a one-PRD-per-output rule, ensuring each generated prd.json maps to a single iteration with machine-verifiable user stories for the Ralph agent.

Does the Ralph prd.json conversion require any specific dependencies or components?

The Ralph prd.json conversion does not require any specific dependencies or components. It functions as a standalone tool that processes markdown or text PRDs to produce a valid JSON structure for autonomous task execution.