subsy/ralph-tui
4 skills3.7k installs9.4k starsGitHub
Install
npx skills add https://github.com/subsy/ralph-tuiSkills in this repo
1Ralph Tui Prdralph-tui-prd is an agent skill for solo builders using ralph-tui who need a structured Product Requirements Document before any coding agent runs. It receives a feature description, asks essential clarifying questions in small batches with lettered options, adaptively follows up, and always asks what quality gates must pass. The resulting PRD includes user stories sized for agent execution and explicit success and integration context, then emits the document inside [PRD]...[/PRD] markers so the TUI can parse and route work to beads issues or prd.json pipelines. It fits the validate moment when scope is still negotiable but you want agent-safe boundaries and test commands locked in early. Because it forbids implementation, it pairs naturally with separate execution skills once the PRD is approved.1.1kinstalls2Ralph Tui Create JsonRalph TUI Create JSON is an agent skill that transforms a product requirements document into the flat prd.json schema expected by ralph-tui’s JSON tracker plugin. The workflow starts by parsing Quality Gates from the PRD—commands like typecheck and lint that must pass for every story, plus optional UI verification steps—then maps user stories, merges gates into acceptance criteria, and declares dependencies so autonomous runs respect build order. A critical constraint is structural: the output must be a top-level object with name and userStories, never wrapped in a prd key or replaced with a generic tasks array. Solo builders who already brainstormed or wrote a PRD can use this skill to avoid manual JSON fiddling and failed ralph-tui runs. Triggers include phrases like create prd.json, convert to json, and ralph json. After the file exists, you typically invoke ralph-tui run with the generated path to let the agent execute stories against your repo gates.968installs3Ralph Tui Create BeadsRalph-tui-create-beads bridges product documents and agentic execution for solo builders using ralph-tui with the Beads tracker. Given a PRD file or pasted markdown, the skill locates Quality Gates—commands like typecheck and lint that must pass for every story, plus optional UI verification steps—and materializes an epic with one child bead per user story, dependencies reflecting sensible build order from schema through backend to UI. Each story carries the appropriate gate checklist so autonomous runs do not skip verification. The result is a `.beads/beads.jsonl` task source you hand to `ralph-tui run --tracker beads` without manually transcribing stories into a tracker. It assumes you already wrote a PRD with user stories and, ideally, an explicit Quality Gates section; if that section is missing, you still get structure but must infer gates carefully. Future tracker plugins may ship sibling skills; this one is Beads-specific. It complements writing-plans-style skills by targeting machine-readable beads rather than human-readable plans alone.857installs4Ralph Tui Create Beads Rustralph-tui-create-beads-rust converts a product requirements document into a beads-rust task graph for Ralph TUI autonomous runs. Solo builders who already captured user stories in markdown can avoid manually typing br commands by letting an agent extract quality gates, mint an epic, spawn child beads per story, and chain dependencies from schema through backend to UI. Each child bead inherits universal checks like typecheck and lint, with extra browser verification called out for UI stories when the PRD demands it. The skill is explicitly tied to the br CLI from beads-rust; teams on the legacy bd tool should use the sibling ralph-tui-create-beads skill instead. Typical flow: finalize PRD → run this skill → launch ralph-tui with the beads-rust tracker so stories execute in dependency order with gates enforced every iteration.843installs