ralph-tui-create-json

Convert PRD content into a flat prd.json with user stories and quality gates.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ashleytower/claude-code-workflow --skill ralph-tui-create-json-ashleytower
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-tui-create-json
Source: https://github.com/ashleytower/claude-code-workflow/tree/main/skills/ralph-tui-create-json
Command: npx skills add https://github.com/ashleytower/claude-code-workflow --skill ralph-tui-create-json-ashleytower

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts PRDs into prd.json format for ralph-tui autonomous execution, enabling seamless task planning from product requirements.

Core Features & Use Cases

  • Extract Quality Gates from the PRD and apply them to each user story so all stories share the same validation criteria.
  • Parse user stories from the PRD and output a flat root-level JSON object containing name, branchName, description, and a userStories array.
  • Derive branchName from the feature name in kebab-case and prepare the data for direct use by Ralph TUI.

Quick Start

Provide a PRD document and run the skill to generate a flat prd.json suitable for ralph-tui.

Frequently Asked Questions about ralph-tui-create-json

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

FAQPage Schema
How do I convert a PRD to prd.json for automated task planning?

To convert a PRD to prd.json, provide the PRD document to the skill to parse user stories, extract quality gates, and output a flat JSON structure with name, branchName, description, and a userStories array for ralph-tui execution.

How does prd.json handle quality gates from a PRD?

Quality gates in prd.json are extracted from the PRD, differentiated into universal and UI gates, and subsequently appended to each individual user story's acceptance criteria to ensure consistent validation across all stories.

How is branchName generated from a PRD feature?

The branchName is automatically derived from the feature name specified in the PRD by converting the text into kebab-case format, ensuring the resulting prd.json is ready for direct use by ralph-tui.

What structure does the generated prd.json use for user stories?

The generated prd.json uses a flat structure containing root-level fields name, branchName, description, and a userStories array, where each story includes generated dependencies and appended quality gate acceptance criteria.

Do I need ralph-tui installed to generate a prd.json from a PRD?

You do not need ralph-tui installed to generate the prd.json file, but the output is specifically formatted with flat root fields and a userStories array for direct consumption by ralph-tui autonomous execution.

Can I parse universal and UI quality gates separately from a PRD?

Yes, the skill parses universal and UI quality gates separately from the PRD content and applies both types of gates to the acceptance criteria of every extracted user story within the final prd.json output.