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.