# Convert PRDs Into Ralph TUI Beads

PRDs can be hard to turn into small, executable agent tasks. This skill converts a PRD into ralph-tui bead plans with quality gates and dependencies.

## Install

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

## Metadata

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

## Capabilities

- Extracts universal and UI-specific quality gates from a PRD.
- Creates an epic bead and child bead plan for each user story.
- Splits large PRD features into one-iteration implementation stories.
- Orders stories by schema, backend, UI, and integration dependencies.
- Adds dependency commands so later beads wait for required earlier beads.
- Links the epic back to the source PRD when a source file is available.

## Use Cases

- Prepare a PRD for agent execution: Convert a product requirement document into an epic and ordered child beads for ralph-tui.
- Create a dependency-aware backlog: Break a feature into schema, backend, UI, and integration tasks with clear blocking relationships.
- Carry quality gates into implementation tasks: Append type checks, lint checks, and UI verification requirements to every relevant bead.

## Prompt Templates

### Create Beads From PRD

```
Convert this PRD into ralph-tui beads. Create one epic, one child bead per user story, and include quality gates from the PRD.
```

### Use a PRD File

```
Read the PRD at the given path and create a ralph-tui Beads plan. Link the epic back to the PRD file.
```

### Split Oversized Stories

```
Review this PRD for oversized stories, split them into one-iteration beads, and keep acceptance criteria verifiable.
```

### Build a Full Dependency Plan

```
Create a dependency-ordered bead plan from this PRD. Start with schema work, then backend, UI, and integration tasks. Add quality gates to every bead.
```

## Limitations

- It is designed for the ralph-tui Beads tracker, not Linear or GitHub Issues.
- It needs a clear PRD or user clarification when quality gates are missing.
- Generated shell commands should be reviewed before execution.
- Complex systems may still need manual dependency adjustments.

## Best Practices

- Add a clear Quality Gates section to the PRD before conversion.
- Keep each user story small enough for one ralph-tui iteration.
- Review generated titles, paths, and dependencies before running commands.

## Anti Patterns

- Do not convert an entire broad feature into one bead.
- Do not use vague acceptance criteria such as works correctly.
- Do not run generated commands without checking PRD-derived strings.

## Security Audit

- Audited at: 2026-07-07T04:22:29.438\+00:00
- Summary: The static findings are Markdown backticks and Bash examples, not executable Ruby or template literal code, so they are false positives as pattern matches. A semantic risk remains because PRD-derived titles are shown inside shell command arguments without explicit escaping, which can lead to command injection if generated commands are run unreviewed.

## Stats

- Views: 151
- Downloads: 9
- Favorites: 0
- Popularity score: 0