ralph

Convert Markdown PRDs into Ralph's prd.json format with validated stories.

Updated Jan 29, 2026

Search Tags:#automation #markdown #json #conversion #prd #ralph

Ready to run

npx skills add https://github.com/grenos/gh-viewer --skill ralph-grenos

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/grenos/gh-viewer/tree/main/.claude/skills/ralph
Command: npx skills add https://github.com/grenos/gh-viewer --skill ralph-grenos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts Markdown PRDs into Ralph's prd.json format to enable automated execution by Ralph-based agents.

Core Features & Use Cases

Read the PRD from tasks/prd-[feature-name].md and convert user stories into compact JSON entries.
Validate story sizing and dependencies, and enforce the one-iteration rule.
Save the result to ralph-cc/prd.json and provide guidance for splitting large PRDs.
Maintain a strict output schema and include Typecheck passes as a verifiable criterion.

Quick Start

Run the Ralph PRD Converter against your PRD in tasks/ to generate ralph-cc/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 autonomous task execution?▼

Converting a Markdown PRD to JSON involves reading tasks/prd-[feature-name].md and transforming user stories into compact JSON entries. The output is saved to ralph-cc/prd.json with a strict schema for autonomous execution.

What is the one-iteration rule for PRD user stories?▼

The one-iteration rule requires that each user story in the PRD JSON must be completable within a single iteration. The converter validates story sizing and dependencies, providing guidance to split large PRDs if they violate this constraint.

How do I validate dependencies and sizing when converting PRDs to JSON?▼

Validating dependencies and sizing when converting PRDs to JSON is handled automatically by the converter. It checks each user story against the one-iteration rule and ensures the strict output schema includes Typecheck passes as a verifiable criterion.

Do I need a specific directory structure to convert PRDs to Ralph JSON?▼

Yes, converting PRDs to Ralph JSON requires placing your Markdown PRD in the tasks/ directory as prd-[feature-name].md. The converter reads from this path and outputs the validated JSON directly to ralph-cc/prd.json.

What is the best way to handle large PRDs that exceed autonomous task limits?▼

The best way to handle large PRDs is to split them into smaller segments. The converter enforces the one-iteration rule for story completion and provides explicit guidance for splitting large PRDs to fit the strict JSON schema.

Why does my PRD JSON conversion require Typecheck passes?▼

Typecheck passes are required as a verifiable criterion within the strict output schema during PRD JSON conversion. This ensures the generated ralph-cc/prd.json is structurally valid and ready for reliable automated execution by Ralph-based agents.