bubbletea-designer

Generate Bubble Tea TUI architecture and implementation plans from natural-language requirements.

3|1|Updated May 18, 2026
One-click install
npx skills add https://github.com/dnlopes/overseer --skill bubbletea-designer-dnlopes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bubbletea-designer
Source: https://github.com/dnlopes/overseer/tree/main/.claude/skills/bubbletea-designer
Command: npx skills add https://github.com/dnlopes/overseer --skill bubbletea-designer-dnlopes

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Bubble Tea TUI design often stalls in the gap between an idea and a working structure, including choosing the right Bubble Tea components, deciding an architecture (model/update/view), and planning the implementation steps.

Core Features & Use Cases

  • Requirement analysis from natural language: Extracts TUI archetype, features (navigation, search, forms, progress, etc.), interaction expectations, and view strategy (single vs multi).
  • Component mapping from requirements: Recommends appropriate Bubble Tea/Bubbles components (e.g., viewport, textinput, table, list, progress/spinner, help, tabs) with scores and justifications.
  • Pattern selection using an examples inventory: Chooses relevant example files from a local charm-examples-inventory to study implementation approaches and best practices.
  • Architecture generation: Produces a component hierarchy and a message-handling plan (including keyboard and resize handlers) plus ASCII diagrams.
  • Implementation workflow + scaffolding guidance: Generates phased task plans, testing checkpoints, and basic code scaffolding guidance to get started quickly.
  • Useful for: planning log viewers, file managers (including preview panes), installers with progress, dashboards, and multi-step wizards.

Quick Start

Describe what you want in one sentence, for example: Design a log viewer with search and highlighting, and the skill will produce a complete design report with requirements, component recommendations, architecture diagrams, and an implementation workflow.

Frequently Asked Questions about bubbletea-designer

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

FAQPage Schema
How do I design a Bubble Tea TUI architecture from natural language requirements?

To design a Bubble Tea TUI architecture from natural language, this Skill extracts structured requirements and maps them to component candidates, generating a complete Model/Init/Update/View architecture with ASCII diagrams.

What's the best way to choose Bubble Tea components for a terminal UI?

Choosing Bubble Tea components for a terminal UI is done by mapping extracted requirements to Bubbles components like viewport, table, and progress, providing scored recommendations with justifications for each selection.

Can I generate an implementation workflow for a Bubble Tea file manager with a preview pane?

Yes, you can generate an implementation workflow for a Bubble Tea file manager with a preview pane by analyzing the requirements, selecting relevant Charmbracelet examples, and producing a phased task plan with testing checkpoints.

How do I plan the message-handling structure for a Bubble Tea dashboard?

Planning the message-handling structure for a Bubble Tea dashboard involves generating a component hierarchy that includes keyboard and resize handlers, ensuring the Model/Update loop correctly processes events for the dashboard views.

Does this Skill provide code scaffolding for terminal UI installers with progress tracking?

Yes, this Skill provides code scaffolding guidance for terminal UI installers with progress tracking by producing a phased workflow that includes basic code scaffolding outputs to help you start implementation quickly.

What are the limitations of using ASCII diagrams for terminal UI component mapping?

ASCII diagrams for terminal UI component mapping visually represent the component hierarchy and message flow, but they are static architectural artifacts that do not execute or interact with the actual Bubble Tea runtime environment.