---

name: beads-review description: Review, proofread, refine, and polish existing Beads epics and issues for clarity, completeness, and smooth implementation. Use after Beads have been filed, or when asked to audit/improve a Beads tracker.

Beads Review

Use this skill to improve an existing Beads epic/issue set so implementers have a smooth path.

Workflow

1. Load beads guidance if needed

   • If bd CLI usage or bead structure is unclear, read /Users/btraut/Development/skills-external/beads/SKILL.md and follow its session protocol.

2. Load the current Beads set

   • Identify all epics and issues under review.
   • If the original plan/spec exists, keep it nearby as the source of truth.

3. Review for clarity and completeness

   • Fix vague titles, missing acceptance criteria, or unclear scope.
   • Ensure each issue can be done by one agent in a single task.
   • Verify dependencies, sequencing, and opportunities for parallel work.

4. Refine and polish

   • Add missing design notes or decision context.
   • Split oversized issues; merge duplicates; remove fluff.

5. Single-pass review

   • Complete one focused pass in the current context.
   • If additional passes are needed, call them out explicitly and recommend either re-running the review or using the ralph skill for isolated multi-pass work.

Output expectations

• Provide a concise summary of changes and any remaining risks or open questions.
• Call out any issues that need user decisions before work begins.