subsy avatar

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-code

Installs 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:

  1. Extract Quality Gates from the PRD's "Quality Gates" section
  2. Create an epic bead for the feature
  3. Create child beads for each user story (with quality gates appended)
  4. Set up dependencies between beads (schema → backend → UI)
  5. 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

More from subsy/ralph-tui

All 4
1kostja94 avatareducation-programkostja94/marketing-skillsWhen the user wants to plan, implement, or optimize student and education discount programs. Also use when the user mentions "student discount," "education disc1Kskills.sh installs
2cursor avatarcreate-learning-pathcursor/pluginsBuild a personalized learning roadmap with milestones and practice checkpoints1Kskills.sh installs
3postplusai avatarmedia-routerpostplusai/postplus-skillsRoute audio, video, transcript, subtitle, and edit-prep requests into the right media-understanding workflow before execution. Use this when the user wants tran992skills.sh installs
4product-on-purpose avatardeliver-edge-casesproduct-on-purpose/pm-skillsDocuments edge cases, error states, boundary conditions, race conditions, and recovery paths for a feature - the systematic catalog of what can go wrong and the934skills.sh installs
5dbt-labs avatarworking-with-dbt-meshdbt-labs/dbt-agent-skillsUse when changing a dbt model in a way that could break its consumers — renaming, removing, or retyping a column, or changing a model that downstream models, ex892skills.sh installs
6product-on-purpose avatardiscover-competitive-analysisproduct-on-purpose/pm-skillsCreates a structured competitive analysis comparing features, pricing, and positioning across 3-5 direct and indirect competitors, with a 2x2 map and actionable881skills.sh installs