Skip to main content
skill CX Codex

bubbletea · pedronauck — Claude Code skill: what it does, how to install

Guides coding agents in building Go terminal interfaces with Bubble Tea and Lip Gloss under the Elm architecture.

MIT 276 installs ★ 655 updated 2026-10-20

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add pedronauck/skills --skill bubbletea -a claude-code
Open on GitHub

What bubbletea does

This skill guides assistants through building Go terminal user interfaces with Bubble Tea and Lip Gloss. It enforces the model-update-view loop, keeping side effects separate from the view rendering logic.

The instructions focus on terminal reality: display width differs from byte length and code point count, so strings must use ANSI-aware measurement. Sizing panes requires measuring actual padding and clamping boundaries, while dependencies must be added through the standard Go workflow rather than manually editing go.mod.

What it helps with

  • build Go TUI components following the Elm model-update-view pattern
  • calculate visual string widths properly with ANSI sequences and emojis
  • handle responsive layouts and clamping across varied terminal sizes
  • manage keyboard and mouse events alongside component focus

Example prompts for the agent

  • Implement a split-pane layout using Lip Gloss that clamps to narrow terminals
  • Handle window resize messages in this Bubble Tea model without breaking the layout
  • Format multiline terminal output using cell-aware truncation instead of byte slicing

How to install bubbletea

1Skills CLI (Vercel)

npx skills add pedronauck/skills --skill bubbletea -a claude-code

2Manually: put the files in place

~/.claude/skills/bubbletea/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/bubbletea/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about bubbletea

How do I install bubbletea in Claude Code?

Run npx skills add pedronauck/skills --skill bubbletea -a claude-code in your terminal.

What does bubbletea do?

It guides the assistant on developing Go TUIs using Bubble Tea and Lip Gloss, covering layout sizing, event handling, and Elm architecture constraints.

How does it handle package dependencies?

It instructs the agent to install dependencies through the repository's standard Go package workflow rather than directly editing go.mod.

Source text

SKILL.md · MIT
---
name: bubbletea
description: "Build interactive Go TUIs with Bubbletea, Elm architecture, Lipgloss, layouts, and keyboard/mouse handling. Excludes plain-text CLIs, web/desktop GUIs, and other TUI frameworks."
license: MIT
metadata:
  author: Pedro Nauck
  github: https://github.com/pedronauck
  repository: https://github.com/pedronauck/skills
---

# Bubble Tea TUI Development

Work with the repository's installed Bubble Tea/Lip Gloss versions and existing model/update/view structure. Use current official docs for version-specific API changes; do not assume bundled examples match the consuming project's major version.

## Implementation

- Reuse nearby components and state ownership. A small widget does not require a new project scaffold, YAML configuration, hot reload, mouse handling, or effects library.
- Before changing layout, inspect the relevant guidance in `references/golden-rules.md`. Measure the actual frame/padding and clamp small-terminal dimensions; subtracting a fixed two cells is valid only for that exact border.
- Use terminal-cell/ANSI-aware measurement and truncation. Do not slice strings by byte length or assume code points equal display width. Choose clipping, wrapping, or scrolling for the content's behavior; not all bordered text must truncate.
- Keep hit-testing consistent with the rendered layout and focus state. Proportional sizing is useful for flexible panes; fixed sizes are valid for intentional controls.
- Keep effectful work outside rendering and preserve the model/update lifecycle. Validate the changed interaction and relevant narrow/wide terminal sizes; add an owning test only when behavior lacks coverage.

## References

| Concern | Read as needed |
| --- | --- |
| Border sizing, panel alignment | `references/golden-rules.md` |
| Existing widget patterns | `references/components.md` |
| Rendering failure | `references/troubleshooting.md` |
| Unicode/emoji alignment | `references/emoji-width-fix.md` |

Bundled templates are optional starting points for a new application. Adapt their API versions and layout assumptions; do not replace a working project structure or add dependencies it does not need. Install required dependencies through the repository's package workflow, not by hand-editing go.mod. Product behavior, terminal constraints, and project conventions take precedence over illustrative examples.

© Pedro Nauck · MIT · pedronauck/skills

Similar skills

All skills for Frontend and UI →

bubbletea by other authors comes first.

bubbletea GGPrompts Builds terminal user interfaces in Go using Bubbletea and Lipgloss. It structures Elm-based apps and prevents layout bugs in multi-panel screens. CX Codex +1 512installs bubbletea-code-review existential-birds bubbletea-code-review reviews Go terminal UIs for Elm architecture, BubbleTea update flow, and Lipgloss styling. Use it when checking code built with charmbracelet/bubbletea. CX Codex +1 270installs wish-ssh-code-review existential-birds wish-ssh-code-review inspects Go SSH server code using charmbracelet/wish for middleware order, session handling, host keys, and graceful shutdown patterns. CX Codex +1 119installs sheets-terminal-spreadsheet reason-machines sheets-terminal-spreadsheet equips AI agents to view and modify CSV files directly via the Go-based sheets terminal interface. CX Codex +1 734installs textual-tui-skill podo textual-tui-skill is a Claude Code skill for building Python terminal interfaces with Textual, covering widgets, styles, background tasks, and tests. CX Codex +1 268installs textual-builder YPares The textual-builder skill guides agents through building terminal interfaces with Textual and prototyping card games. It includes references for widgets, layouts, styling, and interaction. CX Codex +1 7installs powershell-ui-architect VoltAgent Community powershell-ui-architect designs desktop graphical interfaces (WinForms, WPF, Metro) and terminal UIs for PowerShell tools while keeping business logic separate. CX Codex 218installs

From the same set52

The whole set →
rust-best-practices rust-best-practices — a skill for writing, refactoring, and optimizing Rust code with ownership, error handling, Tokio, traits, and testing. Use it for systems programming or async workloads where correctness matters. CX Codex +1 298installs es-toolkit Guides your AI assistant to use es-toolkit utility functions for arrays, objects, and strings instead of custom helpers. CX Codex +1 293installs extreme-software-optimization The extreme-software-optimization skill locates performance hot spots with measurements, then checks that changes preserve behavior. Use it for slow code, latency, throughput, or algorithm work. CX Codex +1 286installs electron-release electron-release guides Electron production builds, signing, notarization, updates, and delivery. Use it when a desktop app is moving from local builds to a release pipeline. CX Codex +1 282installs testing-boss testing-boss guides test writing and LLM eval design: helps pick the right test layer, trim fragile mocks, and diagnose flaky CI suites without adding dummy production code. CX Codex +1 274installs alex-hormozi-pitch The alex-hormozi-pitch skill shapes offers and sales pitches with Alex Hormozi’s method. Use it when you need to work through value, pricing, guarantees, or objections. CX Codex +1 268installs deslop deslop cleans generated code noise and accidental complexity from active diffs before final verification. CX Codex +1 267installs effect-ts Skill for working with Effect-TS, a functional programming library for TypeScript. Guides you through type-safe code with error handling, async operations, and resource management using Effect, Schema, Pattern Matching, and Context.Tag. CX Codex +1 264installs

Project sponsors

Companies that keep this analytics open