ralph-json-create-issues

Convert PRD or plan markdown into prd.json files for Ralph automation.

69|11|Updated Dec 30, 2025

Search Tags:#automation #workflow #planning #json #prd #ralph #plan-management

Ready to run

npx skills add https://github.com/richtabor/agent-skills --skill ralph-json-create-issues

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: ralph-json-create-issues
Source: https://github.com/richtabor/agent-skills/tree/main/skills/ralph-json-create-issues
Command: npx skills add https://github.com/richtabor/agent-skills --skill ralph-json-create-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts a PRD or plan markdown file into prd.json format for Ralph automation, enabling autonomous execution of planned work.

Core Features & Use Cases

Right-sized stories: splits a PRD/plan into individual US entries that fit within a single Ralph iteration.
Dependency handling: detects and populates dependsOn with referenced PRDs across prds/, plans/, and .claude/plans/.
Output readiness: generates prd.json compatible with the ralph-json-start-loop workflow.

Quick Start

Provide the path to your PRD or plan file to convert it into prd.json for Ralph.

Frequently Asked Questions about ralph-json-create-issues

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I convert a PRD markdown file into JSON for workflow automation?▼

You can convert a PRD markdown file into JSON by providing its file path. The tool parses plan-mode outputs from directories like .claude/plans or prds/ and generates a structured prd.json file for automated workflow execution.

Can I use markdown plan files stored in .claude/plans for automated story generation?▼

Yes, markdown plan files in .claude/plans are fully supported. The tool scans this directory alongside plans/ and prds/ to detect and resolve dependsOn relationships across referenced PRDs for accurate dependency handling.

What is the best way to split a large PRD into single-iteration user stories?▼

The best way to split a large PRD into single-iteration user stories is to ensure each story includes explicit acceptance criteria. The tool automatically right-sizes stories to fit within a single automation iteration and outputs them to a feature-specific JSON file.

Does the generated prd.json require explicit acceptance criteria for each story?▼

Yes, the generated prd.json requires explicit acceptance criteria for each story. Correct dependencies and acceptance criteria are mandatory to ensure the output is compatible with the ralph-json-start-loop automation workflow.

How do I resolve dependsOn relationships when converting multiple PRD files?▼

To resolve dependsOn relationships when converting multiple PRD files, the tool automatically detects referenced PRDs across the prds/, plans/, and .claude/plans/ directories and populates the dependency fields in the final JSON output.

Why does my PRD to JSON conversion output to a specific feature-name directory?▼

Your PRD to JSON conversion outputs to prds/[feature-name].json to ensure the generated stories are correctly organized and ready for the automation loop. This standardized output path is required for the workflow to locate and execute the planned stories.