Ralph Tui Create Json

Takes your PRD markdown and spits out the prd.json that ralph-tui needs to run autonomously. The real value is how it handles quality gates: it finds your typecheck and lint commands in the PRD, then appends them to every story's acceptance criteria so ralph knows what needs to pass. It also flattens complex PRDs into the exact schema ralph expects (a flat object with userStories at root, not wrapped in anything). The anti-patterns section is unusually detailed because apparently everyone's first instinct is to nest things in a "prd" wrapper object. Worth using if you're planning multiple ralph runs, less so for one-off tasks where you'd just write the JSON by hand.

skills.sh installs: 1.2K
GitHub stars: 2.5K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add subsy/ralph-tui --skill ralph-tui-create-json --agent claude-code

Installs into .claude/skills of the current project.

Files

Ralph TUI - Create JSON Tasks

Converts PRDs to prd.json format for ralph-tui autonomous execution.

Note: This skill is bundled with ralph-tui's JSON tracker plugin. Future tracker plugins (Linear, GitHub Issues, etc.) will bundle their own task creation skills.

⚠️ CRITICAL: The output MUST be a FLAT JSON object with "name" and "userStories" at the ROOT level. DO NOT wrap content in a "prd" object or use "tasks" array. See "Schema Anti-Patterns" section below.

The Job

Take a PRD (markdown file or text) and create a prd.json file:

Extract Quality Gates from the PRD's "Quality Gates" section
Parse user stories from the PRD
Append quality gates to each story's acceptance criteria
Set up dependencies between stories
Output ready for ralph-tui run --prd <path>

Step 1: Extract Quality Gates

Look for the "Quality Gates" section in the PRD:

## Quality Gates

These commands must pass for every user story:
- `pnpm typecheck` - Type checking
- `pnpm lint` - Linting

For UI stories, also include:
- Verify in browser using dev-browser skill

SKILL.md on GitHub