ralph

Convert Markdown or plain text PRDs into Ralph-compatible prd.json files.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/craftwerk-studio/claude-boilerplate --skill ralph-craftwerk-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/craftwerk-studio/claude-boilerplate/tree/main/.claude/skills/ralph
Command: npx skills add https://github.com/craftwerk-studio/claude-boilerplate --skill ralph-craftwerk-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts PRDs into the prd.json format used by the Ralph autonomous agent system to enable automated task planning and execution from product requirements.

Core Features & Use Cases

  • PRD to prd.json conversion: Parses PRD text (markdown or plain) and outputs a Ralph-ready prd.json in the ralph directory.
  • Structured output: Generates the project, branchName, description, and userStories in a standard schema suitable for Ralph ingestion.
  • Guided workflow: Supports single-shot conversion and clear guidance for splitting large PRDs into discrete user stories.

Quick Start

Provide a PRD in Markdown or plain text, and the skill will output a prd.json ready for Ralph.

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

To convert a PRD into JSON for autonomous agent execution, provide Markdown or plain text product requirements to generate a Ralph-compatible prd.json containing project details and user stories for automated task planning.

What is the required structure of a prd.json file for automated task planning?

A prd.json file for automated task planning requires a schema including project, branchName, description, and userStories fields to ensure proper ingestion and autonomous execution by the agent system.

Can I use a plain text PRD to generate structured user stories for development?

Yes, you can use plain text or Markdown PRDs to generate structured user stories. The conversion parses the input and outputs discrete user stories within a standardized JSON schema.

How should I handle large product requirements when converting to JSON?

When handling large product requirements for JSON conversion, the workflow provides guidance for splitting documents into discrete user stories, ensuring the generated JSON remains structured for autonomous execution.

Does the PRD conversion require any specific dependencies or environments?

PRD conversion requires no external dependencies. It directly parses Markdown or plain text inputs and outputs a valid prd.json file into the ralph directory for the autonomous agent workflow.