Bubbletea Code Review

Reviews Go code that uses charmbracelet/bubbletea for terminal UIs, checking whether you're following the Elm architecture correctly. The main thing it does is stop you from blocking the UI thread with file I/O or network calls in your Update function, which is surprisingly easy to get wrong. It also catches common false positives like flagging tea.Cmd returns as blocking when they're actually fine. Includes gates that force it to cite actual line numbers before calling something critical and to read the Elm architecture reference before complaining about command patterns. Useful if you're building a TUI and want to avoid the "why is my interface frozen" debugging session.

skills.sh installs: 265
GitHub stars: 87
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add existential-birds/beagle --skill bubbletea-code-review --agent claude-code

Installs into .claude/skills of the current project.

Files

BubbleTea Code Review

Hard gates (sequence)

Advance only when each pass condition is objectively true (reduces false positives on tea.Cmd and unsubstantiated blocking claims):

Gate	Pass condition
G1 — Anti–false-positive	You skimmed NOT Issues below or read references/elm-architecture.md before recording a finding about `tea.Cmd` returns, value receivers on `Update`, or nested child `Update`.
G2 — Evidence for blocking / suspicious I/O	Each Critical/Major finding names file path + line (or a short quoted snippet) showing the blocking call, `huh.Form.Run` in the wrong place, or other asserted anti-pattern—not a hypothetical.
G3 — Verification	Before publishing review output, you applied the review-verification-protocol to each proposed finding.