ralph

Convert PRD markdown or text into a Ralph-compatible prd.json file.

1|Updated Dec 17, 2025
One-click install
npx skills add https://github.com/Radiants-DAO/radtools --skill ralph-radiants-dao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/Radiants-DAO/radtools/tree/main/.archive/docs-review/skills/ralph/ralph
Command: npx skills add https://github.com/Radiants-DAO/radtools --skill ralph-radiants-dao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert PRDs to Ralph's prd.json format for use with the Ralph autonomous agent system, enabling structured planning and automated execution from natural-language product documents.

Core Features & Use Cases

  • PRD parsing and validation to extract title, description, and user stories
  • Generate a Ralph-ready prd.json containing fields: project, branchName, description, and userStories
  • Create deterministic branch names by converting feature titles into kebab-case for versioning and collaboration
  • Support conversion of markdown PRDs or plain text PRDs into machine-readable plans for Ralph automation

Quick Start

Provide a PRD text or file to start the conversion process and get a prd.json in your Ralph directory.

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 prd.json file for autonomous execution?

To convert a markdown PRD into a prd.json file, provide the PRD text to the tool which parses and validates the content to generate a machine-readable JSON plan containing project, branchName, description, and userStories fields for autonomous execution.

What is the required structure for a Ralph-compatible prd.json file?

A Ralph-compatible prd.json file requires specific fields including project, branchName, description, and userStories. The generated output adheres to this required structure and includes a Typecheck passes criterion to ensure valid automated execution.

Can I use plain text PRDs to generate a structured JSON plan, or is markdown required?

You can use plain text PRDs to generate a structured JSON plan as markdown is not required. The conversion tool supports parsing both markdown and plain text PRDs to extract titles, descriptions, and user stories into the required JSON format.

How are branch names generated from feature titles during PRD conversion?

Branch names are generated by converting feature titles extracted from the PRD into deterministic kebab-case strings. This creates consistent branch names for versioning and collaboration within the generated Ralph-compatible prd.json file.

Does the prd.json conversion process validate user stories for automated execution?

The conversion process parses and validates user stories extracted from the provided PRD to ensure they fit the required JSON structure. This validation guarantees the output includes the necessary Typecheck passes criterion for successful autonomous execution.