bubbletea-code-review

Review BubbleTea TUI Go code for Elm architecture and Lipgloss styling conventions.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/javierhbr/random-poc --skill bubbletea-code-review-javierhbr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bubbletea-code-review
Source: https://github.com/javierhbr/random-poc/tree/main/custom-skills/beagle-main/plugins/beagle-go/skills/bubbletea-code-review
Command: npx skills add https://github.com/javierhbr/random-poc --skill bubbletea-code-review-javierhbr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers ensure their BubbleTea TUI applications adhere to best practices, preventing common bugs and improving code quality.

Core Features & Use Cases

  • Elm Architecture Validation: Checks for correct use of tea.Cmd and immutability.
  • Pattern Recognition: Identifies and flags blocking I/O in Update functions.
  • Use Case: Before merging a new feature for a terminal-based dashboard, run this Skill to automatically catch potential performance issues or architectural mistakes in the BubbleTea code.

Quick Start

Use the bubbletea-code-review skill to review the provided Go code for Elm architecture adherence.

Frequently Asked Questions about bubbletea-code-review

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

FAQPage Schema
How do I check my BubbleTea code for Elm architecture anti-patterns?

To check BubbleTea code for Elm architecture anti-patterns, review your Go source to ensure the model/update/view separation is maintained, tea.Cmd handles asynchronous operations, and no blocking I/O runs inside the Update function.

Why does my BubbleTea TUI freeze during Update operations?

Your BubbleTea TUI freezes during Update operations because blocking I/O is running synchronously inside the Update function, violating Elm architecture conventions; asynchronous tasks must be dispatched as tea.Cmd commands to keep the event loop responsive.

What is the correct way to use tea.Cmd for asynchronous operations in BubbleTea?

The correct way to use tea.Cmd for asynchronous operations in BubbleTea is to return commands from the Update function for non-blocking execution, ensuring the model remains immutable and the view renders without waiting for I/O tasks to complete.

Can I review Lipgloss styling conventions in my Go TUI code?

You can review Lipgloss styling conventions in your Go TUI code by validating that style definitions are composed correctly and consistently, ensuring your BubbleTea components follow standard Elm architecture patterns for rendering and state management.

How do I validate immutability in BubbleTea model states?

To validate immutability in BubbleTea model states, review your Go code to ensure the Update function returns a new model instance rather than mutating the existing state, preventing common anti-patterns that break the Elm architecture data flow.

What are common BubbleTea component composition mistakes to look for before merging?

Common BubbleTea component composition mistakes to look for before merging include mutable model states, blocking I/O in Update functions, improper tea.Cmd usage for async operations, and deviations from standard Elm architecture model/update/view patterns.