Can it fix broken terminal states after a crash?

Yes, it helps implement terminal recovery patterns and panic handling to ensure the user's terminal is correctly restored even if the application fails.

Does it work with Lipgloss styling?

Absolutely. It specializes in fixing layout arithmetic, accounting for padding and margins, and replacing hardcoded dimensions with dynamic terminal sizing.

How does this skill improve TUI performance?

It identifies blocking I/O or expensive calculations in the Update and View loops and provides code to move those operations into tea.Cmd goroutines.

Can it help with unit testing TUIs?

Yes, it checks for teatest coverage and suggests interaction tests to ensure your TUI messages and state transitions are working as expected.

What architectural improvements does it suggest?

It identifies when a model is too complex and provides templates to refactor it into a Model Tree, where child models handle specific parts of the UI.

Bubble Tea Maintenance & Debugging

Name: Bubble Tea Maintenance & Debugging
Author: Human-Frontier-Labs-Inc

byHuman-Frontier-Labs-Inc

•

Developer Tools

Optimizes and debugs Go-based Terminal User Interfaces (TUIs) built with the Bubble Tea framework and Lipgloss.

About

This Claude Code skill is a specialized agent for maintaining, refactoring, and optimizing Go applications built on the Bubble Tea framework. It analyzes TUI code to detect performance bottlenecks in the event loop, identify memory leaks, and fix layout arithmetic issues caused by hardcoded dimensions. By applying a standard set of 11 expert tips, it helps developers transition from monolithic models to efficient model tree architectures, ensures proper terminal recovery after panics, and validates Lipgloss styling for responsive terminal designs.

Key Features

1 GitHub stars
Best practice validation against 11 expert Bubble Tea implementation tips
Architectural refactoring templates for hierarchical model trees
Intelligent Lipgloss layout correction for dynamic terminal sizing
Automated diagnosis of blocking operations in Update and View functions
Performance profiling for event loops and rendering cycles

Use Cases

Refactoring flat TUI models into scalable, composable architectures
Fixing lag and responsiveness issues in complex terminal applications
Debugging layout overflows and styling inconsistencies across terminal sizes

About

Key Features

1 GitHub stars
Best practice validation against 11 expert Bubble Tea implementation tips
Architectural refactoring templates for hierarchical model trees
Intelligent Lipgloss layout correction for dynamic terminal sizing
Automated diagnosis of blocking operations in Update and View functions
Performance profiling for event loops and rendering cycles

Use Cases

Refactoring flat TUI models into scalable, composable architectures
Fixing lag and responsiveness issues in complex terminal applications
Debugging layout overflows and styling inconsistencies across terminal sizes