# Create ralph-tui JSON Task Files

Teams often need a clean task file before ralph-tui can execute a PRD. This skill converts requirements into structured user stories with dependencies and quality gates.

## Install

```bash
npx skillstore add subsy/ralph-tui-create-json
```

## Metadata

- Status: approved
- Slug: subsy-ralph-tui-create-json
- Skillstore revision: r1
- Version status: missing
- Tree hash: 1a3351c969ba0bf8f1fae413fe3ffdfdcfe969e0db9b08feafe3b6dc458df8df
- Author: subsy
- GitHub username: subsy
- License: MIT
- Repository: https://github.com/subsy/ralph-tui/tree/main/skills/ralph-tui-create-json/
- Ref: f93e9bb0daca99badb6a7e574b97737155d57cb3
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands
- Quality score: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/subsy-ralph-tui-create-json
- Manifest: https://skillstore.pages.dev/api/skills/subsy-ralph-tui-create-json/manifest

## Capabilities

- Extracts quality gates from PRD text or asks when gates are missing.
- Converts PRD user stories into a flat prd.json structure.
- Adds acceptance criteria, priorities, passes flags, and notes fields.
- Builds dependency order with dependsOn story references.
- Suggests the default output path for ralph-tui task files.
- Warns against schema patterns that ralph-tui rejects.

## Use Cases

- Prepare Feature PRDs: Convert a feature PRD into stories that ralph-tui can process in dependency order.
- Standardize Task Files: Create consistent prd.json files with required fields and quality gates across projects.
- Split Large Initiatives: Break broad requirements into smaller stories that fit one ralph-tui iteration.

## Prompt Templates

### Create Basic Task File

```
Convert this PRD into a ralph-tui prd.json task file. Use clear user stories, acceptance criteria, and dependencies.
```

### Add Quality Gates

```
Create prd.json from this PRD. Add the listed quality gates to every story and include UI verification where relevant.
```

### Refine Story Size

```
Review this draft task plan for ralph-tui. Split stories that are too large and keep dependencies accurate.
```

### Convert Complex Roadmap

```
Flatten this phased roadmap into ralph-tui user stories. Preserve delivery order, quality gates, and acceptance criteria.
```

## Limitations

- It does not execute ralph-tui or validate task completion.
- It depends on clear PRD content for accurate story extraction.
- It does not resolve unclear product decisions without user input.
- It is designed for the bundled JSON tracker workflow.

## Best Practices

- Provide the full PRD and any required quality gates before conversion.
- Keep each user story small enough for one ralph-tui iteration.
- Review dependencies before running ralph-tui against the generated task file.

## Anti Patterns

- Do not wrap the task data in extra root objects.
- Do not combine an entire feature into one large story.
- Do not use vague acceptance criteria that cannot be verified.

## Security Audit

- Audited at: 2026-07-07T04:30:20.32\+00:00
- Summary: All static findings are false positives caused by Markdown code fences, inline field names, and example CLI commands. No executable scripts, prompt injection attempts, reconnaissance behavior, or data exfiltration intent were found in SKILL.md.

## Stats

- Views: 129
- Downloads: 10
- Favorites: 0
- Popularity score: 0