ralph

Convert a PRD into Ralph's prd.json format with user stories.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts an existing PRD into Ralph's prd.json format, enabling seamless integration into Ralph's autonomous execution loop.

Core Features & Use Cases

  • PRD to PRD.json conversion: Transform a markdown or text PRD into a structured prd.json with branchName, description, and userStories suitable for Ralph.
  • One-PRD-to-one-PRD.json mapping: Generates a clean, one-to-one representation of stories per PRD, preserving priorities and dependencies.
  • Use Case: When you have a PRD ready and want to kick off Ralph with a ready-to-run set of user stories.

Quick Start

Use the ralph skill to convert an existing PRD (markdown) into prd.json in your project's Ralph folder.

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 into Ralph's prd.json format?

Convert a PRD into prd.json by using the ralph Skill to transform your markdown or text PRD into a structured JSON file with branchName, description, and user stories formatted for Ralph's autonomous execution. The output includes story fields: id, title, description, acceptanceCriteria, priority, passes, and notes.

What should a PRD contain before converting it to prd.json?

Your PRD should contain project information, a clear description, and a list of user stories with priorities and acceptance criteria. The ralph Skill will parse these into a structured prd.json with one-to-one story mapping, preserving priorities and dependencies needed for Ralph execution.

Can I automate PRD to user story conversion?

Yes. The ralph Skill automates PRD-to-JSON conversion, transforming markdown or text PRDs directly into executable user story sets with structured fields. This eliminates manual formatting and prepares stories immediately for Ralph's autonomous agent loop.

What output format does the ralph Skill generate?

The Skill outputs a prd.json file containing project metadata, branchName, description, and a userStories array. Each story includes id, title, description, acceptanceCriteria, priority, passes, and notes—all ready for Ralph to execute autonomously.

When should I use PRD-to-JSON conversion instead of manual story entry?

Use conversion when you have an existing PRD ready and want to skip manual restructuring. The ralph Skill is ideal for quickly onboarding markdown or text PRDs into Ralph's execution pipeline without hand-coding JSON or re-entering story data.

Does the conversion preserve story priorities and dependencies?

Yes. The ralph Skill maintains one-to-one story mapping and preserves priorities and dependencies from your original PRD, ensuring the converted prd.json reflects your intended execution order and story relationships.