tui-design

Installation
SKILL.md

TUI & CLI Design

Design terminal software that is calm, predictable, fast, and honest about the medium. Treat this file as the workflow and cross-cutting contract. Load detailed guidance from the one reference that owns it instead of reconstructing or repeating it here.

Route before answering

Need Authoritative reference
Go, Bubble Tea, Lipgloss, Bubbles, tview, gocui references/ecosystem-go.md
Rust, Ratatui, crossterm, Cursive references/ecosystem-rust.md
Python, Textual, Rich, prompt_toolkit, urwid references/ecosystem-python.md
TypeScript/JavaScript, Ink, OpenTUI, Clack, Inquirer references/ecosystem-typescript.md
One-shot commands, arguments, streams, exit codes, --json and errors, completions, paging, config, Windows, CLI testing, automation references/cli-basics.md
Layouts and wireframes, inline vs alternate screen, borders, hierarchy, color, density, responsive behavior and the floor size, states (empty, loading, partial, error, stale), tables, diff views, modals, status bars and messages, progress and spinners, themes, icons and Nerd Fonts, localization and Unicode width, accessibility (screen readers, plain mode, motion) references/visual-patterns.md
Keys, the Esc/q/Ctrl+C quit order, keys that tmux or the key encoding steal, focus, navigation, search and filter, multi-select, help and the command palette, scrolling, live-data selection, log follow mode, trees, text input, forms, mouse, confirmation, undo references/interaction-patterns.md
Flicker or tearing, escape sequences and terminal modes (bracketed paste, keyboard protocol and a Shift+Enter that doesn't arrive, mouse, focus, synchronized output, cursor, title, progress), tmux, screen, Zellij, SSH, and Windows behavior, clipboard, links, notifications, color depth and theme detection references/terminal-protocols.md
Case studies: lazygit, k9s, fzf, btop, helix, yazi, atuin references/exemplar-apps.md
Screenshots or demo recordings The vhs-cli-demos skill when installed; otherwise references/cli-basics.md → Demo recordings
Installs
274
GitHub Stars
48
First Seen
Apr 29, 2026