
Ralph Tui Create Beads
This converts your PRD markdown into a structured epic and child beads that ralph-tui can execute autonomously. It extracts quality gates from your PRD, splits user stories into right-sized tasks (completable in one agent context window), sets up dependencies so schema changes happen before backend before UI, and outputs beads in .beads/beads.jsonl format. The heredoc syntax handling is solid, preventing shell interpretation issues with backticks and variables in descriptions. The one-story-per-iteration sizing guidance is critical since ralph-tui spawns fresh agents with no memory between runs. If you're planning to feed PRDs to ralph and want proper task decomposition with verification gates baked in, this handles the busywork of creating that structure.
- skills.sh installs
- 1K
- GitHub stars
- 2.5K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add subsy/ralph-tui --skill ralph-tui-create-beads --agent claude-codeInstalls into .claude/skills of the current project.
Files
Ralph TUI - Create Beads
Converts PRDs to beads (epic + child tasks) for ralph-tui autonomous execution.
Note: This skill is bundled with ralph-tui's Beads tracker plugin. Future tracker plugins (Linear, GitHub Issues, etc.) will bundle their own task creation skills.
The Job
Take a PRD (markdown file or text) and create beads in .beads/beads.jsonl:
- Extract Quality Gates from the PRD's "Quality Gates" section
- Create an epic bead for the feature
- Create child beads for each user story (with quality gates appended)
- Set up dependencies between beads (schema → backend → UI)
- Output ready for
ralph-tui run --tracker beads
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
Extract:
- Universal gates: Commands that apply to ALL stories (e.g.,
pnpm typecheck) - UI gates: Commands that apply only to UI stories (e.g., browser verification)
Sponsors
Details
- Repository
- github.com/subsy/ralph-tui
- Category
- Productivity & Planning