# Convert PRDs Into Ralph TUI Beads

Large PRDs are difficult to turn into executable ralph-tui work. This skill converts PRD stories into beads with dependencies and quality gates.

## Install

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

## Metadata

- Status: approved
- Slug: subsy-ralph-tui-create-beads-rust
- Skillstore revision: r1
- Version status: missing
- Tree hash: ccb29b4e3092bbedc61b230b4427b2fd72fe1334bab951b6b71639eaf8677a61
- Author: subsy
- GitHub username: subsy
- License: MIT
- Repository: https://github.com/subsy/ralph-tui/tree/main/skills/ralph-tui-create-beads-rust/
- 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-rust
- Manifest: https://skillstore.pages.dev/api/skills/subsy-ralph-tui-create-beads-rust/manifest

## Capabilities

- Extracts quality gates from PRDs and appends them to story acceptance criteria.
- Creates an epic bead and child beads for user stories using br commands.
- Splits large PRD features into smaller stories for one ralph-tui iteration.
- Orders work by dependencies, from schema changes to backend and UI.
- Adds dependency links with br dep add and syncs bead changes for tracking.

## Use Cases

- Prepare PRD Execution: Turn a product requirements document into ordered beads that ralph-tui can execute with clear acceptance criteria.
- Plan Agent-Sized Stories: Break broad features into small implementation tasks that fit one autonomous coding iteration.
- Add Quality Gates: Carry test, lint, typecheck, and browser verification requirements into each generated bead.

## Prompt Templates

### Convert a PRD File

```
Use this skill to convert ./tasks/billing-prd.md into beads-rust tasks. Preserve the PRD quality gates and show the planned dependency order first.
```

### Create Smaller Stories

```
Review this PRD and split any oversized user stories before creating beads. Keep each story small enough for one ralph-tui iteration.
```

### Apply Custom Gates

```
Convert this PRD into br beads. Add npm run typecheck, npm run lint, and browser verification to every relevant acceptance checklist.
```

### Build Dependency Chain

```
Create a beads-rust epic from this PRD and make dependencies explicit. Order schema work first, backend work second, and UI work last.
```

## Limitations

- Requires beads-rust and the br CLI to be installed and initialized.
- Depends on PRD quality, so vague stories may need user clarification.
- Does not prove that generated implementation tasks are complete for every codebase.
- Generated bead data may include sensitive PRD details if committed.

## Best Practices

- Review the PRD for sensitive details before generating beads.
- Confirm quality gates before creating child tasks.
- Inspect generated dependency order before running ralph-tui.

## Anti Patterns

- Do not convert vague acceptance criteria without clarification.
- Do not create one bead for a full multi-area feature.
- Do not run generated shell commands without reviewing embedded PRD text.

## Security Audit

- Audited at: 2026-07-07T04:26:07.45\+00:00
- Summary: Most static detections are false positives caused by Markdown backticks and fenced examples, not executable Ruby backtick usage. The real risk is the skill's actionable br command construction, where PRD-derived text is placed into shell command substitutions with a fixed heredoc delimiter. No prompt injection attempt was found in the reviewed SKILL.md content.

## Stats

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