ralph

Convert Markdown PRDs into Ralph-compatible prd.json files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts existing PRDs into Ralph's prd.json format, enabling automated execution workflows for features described in PRDs.

Core Features & Use Cases

  • Transform a Markdown PRD into a Ralph-ready JSON structure containing project, branchName, description, and userStories.
  • Validate that the resulting JSON matches Ralph's expected schema and supports one-iteration user stories.
  • Use Case: Given a PRD for a feature, generate prd.json that Ralph can consume to plan work across iterations.

Quick Start

Use the ralph skill to convert tasks/prd-example.md to prd.json

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 to JSON for automated feature execution?

To convert a Markdown PRD to JSON, this Skill transforms plain text or Markdown descriptions into a structured prd.json file containing project, branchName, description, and userStories for autonomous execution workflows.

What is the required JSON schema for Ralph's prd.json format?

The required prd.json format includes project, branchName, description, and userStories fields. This schema supports deterministic generation of one-iteration user stories for downstream automated planning.

Can I use plain text product descriptions to generate Ralph-compatible JSON?

Yes, you can use plain text product descriptions to generate Ralph-compatible JSON. The Skill processes both Markdown PRDs and plain text inputs to produce valid prd.json output for autonomous feature execution.

What's the best way to automate PRD conversion for product management workflows?

Automating PRD conversion is best handled by transforming Markdown PRDs into Ralph's prd.json format, which validates the JSON against the expected schema to enable deterministic generation of user stories across iterations.

Does the converted prd.json support multiple iterations for user stories?

The converted prd.json supports one-iteration user stories designed for deterministic generation. The output adheres to Ralph's expected schema, allowing Ralph to consume and plan work across downstream iterations.