bubbletea-code-review

Review BubbleTea terminal UI code for Elm-architecture and Lipgloss styling conformance.

75|9|Updated Dec 21, 2025
One-click install
npx skills add https://github.com/existential-birds/beagle --skill bubbletea-code-review-existential-birds
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bubbletea-code-review
Source: https://github.com/existential-birds/beagle/tree/main/skills/bubbletea-code-review
Command: npx skills add https://github.com/existential-birds/beagle --skill bubbletea-code-review-existential-birds

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates code review for BubbleTea terminal applications, ensuring proper model immutability and command patterns.

Quick Start

Review your BubbleTea model's Update function to ensure it returns a new model instead of mutating state.

Core Features & Use Cases

  • Architecture Validation: Check model immutability, command usage, and Lipgloss styling patterns.

Frequently Asked Questions about bubbletea-code-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I ensure my BubbleTea model follows Elm architecture patterns?

Elm architecture in BubbleTea requires immutable models, pure update functions returning new state, and view functions that render based on model state. This Skill detects whether your model/update/view separation conforms to these patterns, checking that Update returns a new model instance rather than mutating existing state.

What does proper command usage look like in BubbleTea applications?

Commands in BubbleTea enable non-blocking I/O and side effects without mutation. Proper usage means returning tea.Cmd from Update, batching commands correctly, and avoiding blocking operations in model updates. This Skill validates that your command patterns follow these rules.

How do I structure Lipgloss styling correctly in BubbleTea terminal UIs?

Lipgloss styling should separate concerns: styling logic stays distinct from view rendering, and styles are applied consistently across components like lists, tables, viewports, and text inputs. This Skill checks that your Lipgloss usage maintains this separation and applies responsive styling properly.

Can I use this code review for existing BubbleTea projects?

Yes, this Skill applies to any Go codebase using charmbracelet/bubbletea. It evaluates model immutability, command batching, component composition, and Lipgloss styling across common TUI elements. No setup or dependencies beyond BubbleTea itself are required.

What happens if my BubbleTea model mutates state in the Update function?

State mutation violates Elm architecture and causes bugs in TUI applications. This Skill detects when Update modifies existing model state instead of returning a new instance, flagging this anti-pattern so you can refactor to immutable updates.