skills.rest
dnlopes
dnlopesCOMMUNITY
Explore all skills by this author →
𝕏@davnlopesGitHub

bubbletea-maintenance

Diagnose performance, layout, architecture, and reliability issues in Bubble Tea Go applications.

3|1|Updated May 18, 2026
Search Tags:#performance profiling#bubbletea#lipgloss#architecture refactor#tui debugging#go code analysis#terminal recovery
One-click install
npx skills add https://github.com/dnlopes/overseer --skill bubbletea-maintenance
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bubbletea-maintenance
Source: https://github.com/dnlopes/overseer/tree/main/.claude/skills/bubbletea-maintenance
Command: npx skills add https://github.com/dnlopes/overseer --skill bubbletea-maintenance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps you quickly identify why your Bubble Tea app is laggy, broken on resize, or difficult to maintain, then points you to concrete improvements in your Go code.

Core Features & Use Cases

  • Issue Diagnosis: Detects common Bubble Tea problems like blocking work in Update()/View(), hardcoded terminal dimensions, missing terminal recovery, message ordering assumptions, model complexity, and likely goroutine leaks.
  • Best-Practices Validation: Scores your code against 11 expert Bubble Tea tips (fast event loop, debug message dumping, live reload presence, receiver method conventions, safe message ordering, model-tree suitability, lipgloss layout arithmetic, terminal recovery, teatest usage, VHS demos, and optional resources).
  • Performance & Layout Analysis: Finds bottlenecks in Update()/View() (string allocations, regex compilation in hot paths, expensive rendering patterns, sync I/O) and flags Lipgloss layout issues (hardcoded sizing, incorrect height math, padding/border accounting, overflow risk, and missing WindowSizeMsg resize handling).

Quick Start

Tell the agent: Analyze my Bubble Tea application at /path/to/your/app and return a prioritized list of fixes with an overall health score.

Frequently Asked Questions about bubbletea-maintenance

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

FAQPage Schema
How do I fix a slow or laggy Bubble Tea TUI application in Go?▼

Fix a laggy Bubble Tea application by detecting blocking operations in Update() or View(), identifying string allocations and synchronous I/O in hot paths, and resolving unsafe concurrent message handling that starves the event loop.

Why does my Lipgloss layout break on terminal resize?▼

Lipgloss layout breaks on resize when code uses hardcoded terminal dimensions and misses WindowSizeMsg handling. Fix this by correcting height math, padding, and border accounting to manage overflow risk dynamically.

How do I diagnose goroutine leaks and message ordering issues in Bubble Tea?▼

Diagnose Bubble Tea goroutine leaks and message ordering issues by parsing Go source code for unsafe concurrent message handling and validating against safe ordering assumptions to generate severity-scored structural findings.

Can I validate my Go TUI code against Bubble Tea best practices?▼

Validate your Go TUI code against 11 expert Bubble Tea best practices, scoring compliance on fast event loops, debug message dumping, live reload presence, receiver method conventions, teatest usage, and VHS demo generation.

What causes missing terminal recovery in Bubble Tea applications?▼

Missing terminal recovery in Bubble Tea applications occurs when code fails to restore terminal state on exit. Detect this by analyzing Go source patterns to ensure proper cleanup and resource handling during application termination.

Related Skills

Explore More Software Engineering Skills→
baphledbaphled
1

bubble-tea-expert

Guide Go TUI development with Bubble Tea's Elm Architecture and Lip Gloss styling.

Community
Intermediate
javierhbrjavierhbr

bubbletea-code-review

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

Community
Intermediate
chadanandachadananda

tui-viewer

Capture TUI screenshots and analyze colors, text, and layout.

Community
Advanced
hoangtran1411hoangtran1411
2

Go TUI with Bubble Tea

Create interactive terminal user interfaces in Go with Bubble Tea and Lipgloss.

Community
Intermediate