ralph

Convert Markdown or plain-text PRDs into Ralph's prd.json schema.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/AlejandroFigini/artist-portfolio --skill ralph-alejandrofigini
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/AlejandroFigini/artist-portfolio/tree/main/.agent/skills/ralph
Command: npx skills add https://github.com/AlejandroFigini/artist-portfolio --skill ralph-alejandrofigini

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts PRDs into Ralph-compatible prd.json format to enable autonomous execution pipelines.

Core Features & Use Cases

  • PRD-to-JSON conversion: transforms a markdown PRD into Ralph's prd.json schema stored in the Ralph directory.
  • Structured output: generates a JSON object with project, branchName, description, and userStories aligned to Ralph's expectations.
  • Use Case: Given a PRD, produce a ready-to-run prd.json that can drive automation tasks in Ralph.

Quick Start

Paste your PRD text and run the converter to generate a prd.json in the 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 PRD from markdown to JSON format?

Converting a markdown PRD to JSON requires a transformer that parses the text and outputs a structured prd.json file containing project, branchName, description, and userStories fields aligned to Ralph's schema.

What is the required structure for a valid prd.json file?

A valid prd.json structure requires project, branchName, description, and userStories fields, alongside typecheckable fields and example user story entries to ensure proper schema alignment for autonomous execution pipelines.

Can I use plain text PRDs or does the conversion require markdown?

You can use plain text PRDs for conversion. The tool processes both markdown and plain text PRD inputs, transforming either format into a structured prd.json file that matches Ralph's specific execution schema.

How does a structured prd.json enable autonomous execution pipelines?

A structured prd.json enables autonomous execution by providing a standardized JSON schema with project details and user stories. This format drives automation tools by ensuring inputs are typecheckable and ready for automated processing.

What is the best way to generate user stories from a PRD?

The best way to generate user stories from a PRD is to use an automated converter that parses the requirements and outputs a prd.json file containing structured userStories entries aligned with Ralph's specific execution schema.