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 |