tui-fundamentals — скилл для Claude Code: установка
Скилл tui-fundamentals для Claude Code помогает спроектировать TUI, выбрать фреймворк и проверить архитектуру терминального приложения. Описывает TUI для dashboard, REPL, wizard и интерактивного CLI.
MIT 369 установок ★ 66 обновлён 2026-06-18
npx skills add JosiahSiegel/claude-plugin-marketplace --skill tui-fundamentals -a claude-codeЧто делает tui-fundamentals
Скилл разбирает, когда терминальному продукту нужен полноэкранный TUI, а когда лучше подойдут обычные команды, подсказки или текстовый вывод. Он помогает выбрать между режимами full-screen, inline, prompt-based и hybrid, а также спланировать клавиатурную навигацию, справку и неинтерактивные эквиваленты действий.
Внутри есть правила архитектуры: отделять model, update и view, пересчитывать layout при изменении размера терминала, централизовать raw mode и очистку экрана, не смешивать бизнес-логику с выводом. Матрица сравнивает Ratatui, Textual, Rich, prompt_toolkit, curses, Bubble Tea, Ink и другие фреймворки. Отдельные reference-файлы посвящены выбору фреймворка и архитектуре TUI.
Скилл учитывает TERM=dumb, non-TTY, CI, SSH, tmux/screen и различия Windows. Для короткого скриптуемого потока полноэкранный TUI здесь считается плохим выбором, поэтому перед разработкой стоит определить неинтерактивный вариант каждой важной операции.
Какие задачи решает
- выбрать формат терминального интерфейса для задачи
- сравнить фреймворки для TUI на нужном языке
- разделить состояние, события и рендеринг
- спланировать поведение при изменении размера терминала
- проверить CLI для CI, SSH и non-TTY
Примеры запросов агенту
- Спроектируй терминальный dashboard: выбери между full-screen и inline UI и объясни решение.
- Сравни
Ratatui + Crossterm,Textualиcursesдля нового TUI-приложения. - Проверь архитектуру этого интерактивного CLI: найди проблемы с состоянием, resize и non-TTY режимом.
Как установить tui-fundamentals
1Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill tui-fundamentals -a claude-code2Вручную: положить файлы
~/.claude/skills/tui-fundamentals/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tui-fundamentals/
1Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill tui-fundamentals -a codex2Вручную: положить файлы
.agents/skills/tui-fundamentals/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill tui-fundamentals -a cursor2Вручную: положить файлы
.cursor/skills/tui-fundamentals/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install JosiahSiegel/claude-plugin-marketplace plugins/tui-master/skills/tui-fundamentals2Вручную: положить файлы
.github/skills/tui-fundamentals/SKILL.md1Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill tui-fundamentals -a gemini-cli2Командой платформы
gemini skills install https://github.com/JosiahSiegel/claude-plugin-marketplace --path plugins/tui-master/skills/tui-fundamentalsВручную: положить файлы
.devin/skills/tui-fundamentals/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add JosiahSiegel/claude-plugin-marketplace --skill tui-fundamentals -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о tui-fundamentals
Как установить tui-fundamentals в Claude Code?
Выполните npx skills add JosiahSiegel/claude-plugin-marketplace --skill tui-fundamentals -a claude-code, затем проверьте файл ~/.claude/skills/tui-fundamentals/SKILL.md.
Что делает tui-fundamentals?
Скилл помогает выбрать форму TUI, фреймворк и архитектуру приложения. Он также даёт UX-ограничения и чек-листы готовности терминального продукта.
Когда для CLI лучше выбрать обычный вывод, а не TUI?
Когда поток короткий, рассчитан на скрипты и автоматизацию или должен работать со screen reader и CI, скилл рекомендует line-oriented CLI, prompts либо plain output.
Исходный текст
SKILL.md · MIT
--- name: tui-fundamentals description: | This skill should be used when the user asks to design, create, choose, modernize, or review a terminal UI, text user interface, curses app, dashboard, wizard, REPL shell, prompt flow, or CLI with interactive screens. PROACTIVELY activate for: TUI architecture, terminal-ui design, framework selection, curses vs modern framework, full-screen vs inline UI, app state modeling, widget composition, command palette, keyboard-first workflow, terminal dashboard, interactive CLI UX, and cross-platform terminal product planning. Provides: architecture patterns, framework decision rules, UX guardrails, scope boundaries, and production readiness checklists. --- # TUI Fundamentals, Architecture, and Framework Selection Use this skill when the task is about the shape of the terminal product: what kind of TUI to build, which abstraction to use, how to organize state, or whether a full-screen terminal UI is the right answer. ## First decision: is a TUI appropriate? Prefer a rich TUI when users need continuous visual feedback, multi-step navigation, keyboard-driven exploration, selection among many items, or a dashboard-like control surface. Prefer a line-oriented CLI, prompts, or plain output when the flow is short, scriptable, primarily automation-focused, or likely to be used by screen readers and CI systems. A production terminal product often ships both: - A scriptable CLI surface for automation, accessibility, logs, and non-TTY use. - An optional TUI for exploration, monitoring, bulk selection, or guided workflows. ## Architecture rules 1. **Separate model, update, and view.** Business state should not print directly to the terminal. Rendering consumes state; input produces events; update logic transforms state. 2. **Treat terminal size as input.** Layout must be recomputed from width and height on every resize. Never bake in one terminal size. 3. **Own terminal lifecycle in one place.** Raw mode, alternate screen, mouse, focus, keyboard protocols, and cleanup should be centralized. 4. **Make every action keyboard-operable.** Mouse support is an enhancement, not the primary navigation model. 5. **Design for degradation.** `TERM=dumb`, non-TTY output, missing color, Windows console differences, tmux/screen, SSH, and CI should have clear behavior. 6. **Avoid hidden global terminal writes.** Logs, progress, and background task output must not corrupt the screen. ## Framework selection quick matrix | Need | Strong default | |--|--| | Rust full-screen app with precise rendering | Ratatui + Crossterm | | Python product-grade app with widgets, CSS, async workers | Textual | | Python rich output, progress, tables, markdown, logs | Rich | | Python REPL, shell, completions, complex prompt input | prompt_toolkit | | Classic dependency-light Unix TUI | curses/ncurses | | Go Elm-style app with composable commands | Bubble Tea + Bubbles + Lip Gloss | | Go batteries-included forms/tables/tree views | tview over tcell | | Go portable low-level cell engine | tcell | | React-style terminal components in Node | Ink | | Node DOM-like full-screen widgets | Blessed | | .NET full-screen views | Terminal.Gui | | .NET rich CLI output and prompts | Spectre.Console | Read `references/framework-selection.md` before committing to a framework in a new project. ## Product design checklist - Define the primary user journey in one sentence. - Decide whether the app is full-screen, inline, prompt-based, or hybrid. - List required environments: Windows Terminal, classic conhost, macOS Terminal, iTerm2, GNOME Terminal, Alacritty, SSH, tmux/screen, CI, and logs. - Define minimum terminal dimensions and the small-screen fallback. - Define exit keys, destructive confirmation rules, and recovery instructions. - Define non-interactive equivalents for every essential action. - Decide how help is exposed: footer hints, `?`, command palette, `--help`, docs. ## Failure modes - Building a full-screen UI for a workflow that should be scriptable. - Choosing a low-level escape-sequence approach when a framework already solves layout, input, cleanup, and testing. - Mixing business logic with terminal writes, making tests brittle and rendering inconsistent. - Ignoring screen-reader users, CI, pipes, and `TERM=dumb` until late. - Assuming color, Unicode icons, Nerd Fonts, or mouse support are always available. ## Reference files - `references/framework-selection.md` - Detailed ecosystem comparison and decision tree. - `references/tui-architecture.md` - State, event, lifecycle, logging, and distribution patterns.
© JosiahSiegel · MIT · JosiahSiegel/claude-plugin-marketplace