ralph-tui-create-beads-rust

Convert PRDs to beads for ralph-tui execution using beads-rust (br CLI). Creates an epic with child beads for each user story. Use when you have a PRD and want to use ralph-tui with beads-rust as the task source. Triggers on: create beads, convert prd to beads, beads for ralph, ralph beads, br beads.

1.60x

Quality

77%

Does it follow best practices?

Impact

96%

1.60x

Average score across 3 eval scenarios

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/ralph-tui-create-beads-rust/SKILL.md

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with executable commands and a complete example, and the workflow is clearly sequenced with a verification checklist. Its main weaknesses are repeated dependency-ordering explanations and a monolithic structure with no reference splitting.

Suggestions

Consolidate the three dependency-ordering explanations ('Story Ordering', 'Dependencies with br dep add', 'Conversion Rules') into one section to reduce redundancy.

Move the large worked example and the beads-vs-beads-rust command table into a references/ file, keeping SKILL.md as an overview with one-level-deep links.

Add an explicit validation step after bead creation (e.g., listing/verifying created beads before running ralph-tui) to give the batch workflow a feedback loop.

Dimension	Reasoning	Score
Conciseness	Mostly efficient and free of concepts Claude already knows, but dependency ordering is explained three times ('Story Ordering', 'Dependencies with br dep add', 'Conversion Rules') and could be tightened.	3 / 5
Actionability	Fully executable, copy-paste-ready br create / br dep add / br sync commands with HEREDOC syntax and a complete end-to-end worked example covering the common PRD-to-beads case.	5 / 5
Workflow Clarity	Clear sequence (extract gates -> epic -> children -> deps -> sync) plus a 'Checklist Before Creating Beads' as verification, but lacks an explicit validate/fix/retry feedback loop for the batch creation.	4 / 5
Progressive Disclosure	Well-sectioned but a single ~360-line monolith with no bundle files; large content like the worked example and the beads-vs-beads-rust table is inlined rather than split into references.	3 / 5
	Total	15 / 20 Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, well-triggered, and clearly answers both what and when for a narrow niche. Minor improvements would come from naming dependency/quality-gate actions and adding non-'beads' synonyms.

Dimension	Reasoning	Score
Specificity	Lists several concrete actions ('Convert PRDs to beads', 'Creates an epic with child beads for each user story', 'using beads-rust (br CLI)') but omits key actions surfaced in the body like dependency wiring and quality-gate extraction, leaving minor gaps.	4 / 5
Completeness	Explicitly answers both what ('Convert PRDs to beads... Creates an epic with child beads') and when ('Use when you have a PRD and want to use ralph-tui with beads-rust as the task source') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Provides good natural-keyword coverage ('create beads, convert prd to beads, beads for ralph, ralph beads, br beads') but the terms are mostly repetitive variations of 'beads' and miss synonyms like 'tasks' or 'stories'.	4 / 5
Distinctiveness Conflict Risk	Has a clear niche via 'beads-rust (br CLI)' and ralph-tui, but carries minor overlap risk with the sibling 'ralph-tui-create-beads' (bd) skill noted in the body.	4 / 5
	Total	17 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: subsy/ralph-tui
Path: skills/ralph-tui-create-beads-rust/SKILL.md
Commit: af44322

Reviewed: 12 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.