Agent skill

Bubbletea

by pedronauck in pedronauck/skills

Build interactive Go TUIs with Bubbletea, Elm architecture, Lipgloss, layouts, and keyboard/mouse handling.

MITAuto-check passed

Install Bubbletea

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pedronauck/skills bubbletea --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pedronauck/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mine/bubbletea .claude/skills/bubbletea && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bubbletea
GitHub stars
634
Used in
1 other repo
Token cost
~595 tokens
SKILL.md length
252 words
Files
5 (incl. references)
Skills in repo
65
Repo updated
First seen
Licence
MIT

At a glance

Build interactive Go TUIs with Bubbletea, Elm architecture, Lipgloss, layouts, and keyboard/mouse handling.

  • SKILL.md covers Implementation and References
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Bubbletea is an agent skill from pedronauck/skills. 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.

Its SKILL.md is about 600 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including reference files (for example `references/components.md`, `references/emoji-width-fix.md` and `references/golden-rules.md`).

The repository describes itself as: My personal favorite skills. The licence is MIT.

Example prompts

  • “/bubbletea”

What it can do on your machine

Read from SKILL.md and the folder at commit 0422940. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bubbletea loads about 595 tokens when it runs, and up to ~13k if it reads all its reference files. Until then it costs about 47 tokens; SKILL.md has 252 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~595
With references · SKILL.md plus every file in references/, read only if the agent opens them
~13k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pedronauck/skills at commit 0422940, republished under its MIT licence (© pedronauck). 252 words, ~595 tokens.

Download SKILL.mdSave it as .claude/skills/bubbletea/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
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
metadata.github
https://github.com/pedronauck
metadata.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

ConcernRead as needed
Border sizing, panel alignmentreferences/golden-rules.md
Existing widget patternsreferences/components.md
Rendering failurereferences/troubleshooting.md
Unicode/emoji alignmentreferences/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.

© pedronauck, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in skills/mine/bubbletea of pedronauck/skills.

  • SKILL.md
  • references/components.md
  • references/emoji-width-fix.md
  • references/golden-rules.md
  • references/troubleshooting.md

Open the folder on GitHubat commit 0422940

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in pedronauck/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Bubbletea next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bubbletea compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bubbletea this skillpedronauck/skills6341 repos~595Automated safety check: PassMIT
Prototype Openclaw Tuiopenclaw/openclaw392k—~1.3kAutomated safety check: PassMIT
Interactive CLI Testing With tui-testslopus/happy24k—~603Automated safety check: PassMIT
Remotion Interactivityremotion-dev/remotion62k5 repos~4.8kAutomated safety check: PassCustom licence
Firecrawl Interact Integrationfirecrawl/firecrawl190k1 repos~731Automated safety check: PassISC
Testing Mastracode Tuimastra-ai/mastra29k—~1.5kAutomated safety check: PassCustom licence

Similar skills

  • Prototype Openclaw Tui

    openclaw/openclaw

    Build throwaway, fixture-driven OpenClaw Clack or Pi TUI prototypes and compare multiple interactive variants side by side in tmux without running the full application or touching live state.

    392k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Tests interactive CLI and TUI programs with Microsoft's tui-test, driving prompts, arrow keys and screen output in a real pseudo-terminal.

    24k GitHub stars~603 tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Remotion Interactivity

    remotion-dev/remotion

    Official

    Structure Remotion markup for interactivity. An agent skill from remotion-dev/remotion.

    62k GitHub starsUsed in 5 repos~4.8k tokens
    Media & CreativeAuto-check passed
  • Guides adding Firecrawl's /interact endpoint to product code for pages that need clicks, forms, pagination or logged-in flows beyond plain scraping.

    190k GitHub starsUsed in 1 repo~731 tokens
    Data & AnalyticsAuto-check passed
  • Testing Mastracode Tui

    mastra-ai/mastra

    Testing mastracode TUI features interactively in Konsole. An agent skill from mastra-ai/mastra.

    29k GitHub stars~1.5k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Warp TUI Unit Testing

    warpdotdev/warp

    Explains how to write and run fast unit tests for Warp's headless TUI by rendering element trees to a fixed text grid and asserting on the resulting lines.

    65k GitHub starsUsed in 1 repo~1.8k tokens
    Testing & QAAuto-check passed

More from pedronauck/skills

All 65 skills in this repo
  • Deep Review

    pedronauck/skills

    Review branch diffs, working trees, or PRs in depth with defect, polish and cross-contract coverage.

    634 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed
  • Yc Apply

    pedronauck/skills

    Prepare, review, and package Y Combinator application answers and founder-video notes using the live form and verified founder facts.

    634 GitHub stars~1.3k tokensUpdated 23 days ago
    Auto-check passed
  • Guide technical communication for software developers. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 3 repos~2.3k tokens
    Auto-check passed
  • Tauri V2

    pedronauck/skills

    Tauri v2+ cross-platform app development with Rust backend. An agent skill from pedronauck/skills.

    634 GitHub starsUsed in 2 repos~4.1k tokens
    Auto-check passed
  • Hormozi Ad Factory

    pedronauck/skills

    Generates 150-750+ ad variations using Alex Hormozi's combinatorial Hook x Meat x CTA framework.

    634 GitHub stars~2.1k tokensUpdated 23 days ago
    Auto-check passed
  • Yt Master

    pedronauck/skills

    Plans and improves YouTube ideas, titles, thumbnail concepts, scripts, retention, channel strategy, and metric-based diagnosis.

    634 GitHub stars~736 tokensUpdated 23 days ago
    Auto-check passed

Questions about Bubbletea

What does Bubbletea do?

Build interactive Go TUIs with Bubbletea, Elm architecture, Lipgloss, layouts, and keyboard/mouse handling. Bubbletea is an agent skill from pedronauck/skills. Build interactive Go TUIs with Bubbletea, Elm architecture, Lipgloss, layouts, and keyboard/mouse handling.

How do I install Bubbletea in Claude Code?

Run `npx skills add pedronauck/skills --skill bubbletea -a claude-code`. Or copy the skill folder (skills/mine/bubbletea in pedronauck/skills) into .claude/skills/bubbletea in your project. Claude Code loads it when a task matches its description.

How do I install Bubbletea in Codex?

Run `npx skills add pedronauck/skills --skill bubbletea -a codex`. Or copy the skill folder (skills/mine/bubbletea in pedronauck/skills) into .agents/skills/bubbletea in your project. Codex loads it when a task matches its description.

Can I use Bubbletea in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pedronauck/skills --skill bubbletea -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bubbletea, .gemini/skills/bubbletea, .github/skills/bubbletea and .opencode/skills/bubbletea in your project.

What does Bubbletea need to run?

SKILL.md names no scripts, command-line tools or credentials: Bubbletea is instructions for the agent only.

Does Bubbletea access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Bubbletea safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Bubbletea use?

Bubbletea is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bubbletea use?

About 595 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 12k tokens, read only when the agent opens those files.

What are the alternatives to Bubbletea?

Skills that share tags, products or a category with Bubbletea: Prototype Openclaw Tui (openclaw/openclaw, 392k stars), Interactive CLI Testing With tui-test (slopus/happy, 24k stars), Remotion Interactivity (remotion-dev/remotion, 62k stars) and Firecrawl Interact Integration (firecrawl/firecrawl, 190k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bubbletea?

pedronauck (a GitHub user) maintains it in pedronauck/skills, which has 634 GitHub stars. The repository holds 65 skills in this directory. The repository was last updated on September 14, 2026.

Source: pedronauck/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.