Helper for building terminal user interfaces in Go using the Bubbletea framework and the Elm Architecture.
Install
mkdir -p .claude/skills/bubbletea && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/1841" && unzip -o skill.zip -d .claude/skills/bubbletea && rm skill.zipInstalls to .claude/skills/bubbletea
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Browse Bubbletea TUI framework documentation and examples. Use when working with Bubbletea components, models, commands, or building terminal user interfaces in Go.Key capabilities
- →Retrieve the Bubbletea examples README overview
- →Fetch source code for specific TUI examples
- →Access definitions for Model, Update, View, Cmd, and Msg concepts
- →Identify related Charm libraries including Bubbles, Lipgloss, and Glamour
How it works
The skill uses WebFetch to retrieve the examples README from the Bubbletea GitHub repository and provides direct links to source code for specific components.
Inputs & outputs
When to use bubbletea
- →Building a TUI with lists or tables
- →Implementing keyboard navigation
- →Adding spinners or progress bars
- →Structuring TUI state updates
About this skill
Bubbletea Documentation
Bubbletea is a Go framework for building terminal user interfaces based on The Elm Architecture.
Key Resources
When you need to understand Bubbletea patterns or find examples:
-
Examples README - Overview of all available examples: https://github.com/charmbracelet/bubbletea/blob/main/examples/README.md
-
Examples Directory - Full source code for all examples: https://github.com/charmbracelet/bubbletea/tree/main/examples
How to Use
-
First, fetch the examples README to get an overview of available examples:
WebFetch https://github.com/charmbracelet/bubbletea/blob/main/examples/README.md -
Once you identify a relevant example, fetch its source code from the examples directory.
Common Examples to Reference
list- List component with filteringtable- Table componenttextinput- Text input handlingtextarea- Multi-line text inputviewport- Scrollable contentpaginator- Paginationspinner- Loading spinnersprogress- Progress barstabs- Tab navigationhelp- Help text/keybindings display
Core Concepts
- Model: Application state
- Update: Handles messages and returns updated model + commands
- View: Renders the model to a string
- Cmd: Side effects that produce messages
- Msg: Events that trigger updates
Related Charm Libraries
- Bubbles: Pre-built components (github.com/charmbracelet/bubbles)
- Lipgloss: Styling and layout (github.com/charmbracelet/lipgloss)
- Glamour: Markdown rendering (github.com/charmbracelet/glamour)
When not to use it
- →When working with non-Go terminal interface frameworks
- →When seeking documentation outside of the Bubbletea repository
Limitations
- →Limited to documentation and examples hosted within the Bubbletea repository
How it compares
It automates the retrieval of specific framework examples and core concept definitions instead of manually navigating the GitHub repository.
Compared to similar skills
bubbletea side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| bubbletea (this skill) | 42 | 8mo | No flags | Beginner |
| gentleman-trainer | 2 | 7mo | Review | Intermediate |
| generate-subsystem-skills | 1 | 7mo | No flags | Advanced |
| bump-go-dependencies | 1 | 3mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
gentleman-trainer
Gentleman-Programming
Vim Trainer RPG system patterns for Gentleman.Dots. Trigger: When editing files in installer/internal/tui/trainer/, adding exercises, modules, or game mechanics.
generate-subsystem-skills
llama-farm
Generate specialized skills for each subsystem in the monorepo. Creates shared language skills and subsystem-specific checklists for high-quality AI code generation.
bump-go-dependencies
docker
Update direct Go module dependencies one by one, validating each bump with tests and linter, committing individually, and producing a summary table for a PR description
cli-skills
llama-farm
CLI best practices for LlamaFarm. Covers Cobra, Bubbletea, Lipgloss patterns for Go CLI development.
generating-api-sdks
jeremylongshore
Generate client SDKs in multiple languages from OpenAPI specifications. Use when generating client libraries for API consumption. Trigger with phrases like "generate SDK", "create client library", or "build API SDK".
dbx-regenerate
storj
Regenerate DBX code after making changes to .dbx schema files. Runs code generation, shows diff summary, validates compilation, and reports any errors.