skills.rest
grenos
grenosCOMMUNITY
Explore all skills by this author →
𝕏@vas22847008GitHub

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
One-click install
npx skills add https://github.com/grenos/gh-viewer --skill ralph-grenos
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
grenosgrenos

prd

Generate a structured PRD markdown file from a feature brief.

Community
Advanced
Radiants-DAORadiants-DAO
1

ralph

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

Official
Intermediate
crsieblercrsiebler
1

ralph

Convert markdown or text PRDs into Ralph's prd.json schema.

Community
Intermediate
jellydnjellydn
114

ralph

Convert Markdown or text PRDs into Ralph's prd.json format.

Community
Intermediate