К основному содержанию
скилл CX Codex

tui-fundamentals — скилл для Claude Code: установка

Скилл tui-fundamentals для Claude Code помогает спроектировать TUI, выбрать фреймворк и проверить архитектуру терминального приложения. Описывает TUI для dashboard, REPL, wizard и интерактивного CLI.

MIT 369 установок ★ 66 обновлён 2026-06-18

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add JosiahSiegel/claude-plugin-marketplace --skill tui-fundamentals -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/tui-fundamentals/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tui-fundamentals/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
tui-design-skill podo Скилл tui-design-skill для Claude Code проектирует и проверяет терминальные интерфейсы и CLI на Go, Rust, Python и TypeScript. Помогает создавать TUI с навигацией и интерактивными элементами. CX Codex +1 215установок tui-design hyperb1iss Скилл tui-design для Claude Code помогает проектировать интерфейсы терминальных приложений. Он включается при работе с раскладкой панелей, цветами, клавиатурной навигацией и виджетами. CX Codex +1 1 400установок tui-designer ckorhonen Скилл tui-designer для оформления терминальных интерфейсов в стиле ретро и киберпанк: CRT-эффекты, неоновое свечение, фосфорный зелёный экран. CX Codex +1 6установок textual-tui-skill podo Скилл textual-tui-skill помогает собирать терминальные интерфейсы на Python с Textual: от виджетов и стилей до экранов, фоновых задач и тестов. CX Codex +1 268установок codex-tui-proof Ben Cohen Плагин codex-tui-proof для Claude Code проверяет терминальные интерфейсы в браузере Codex: вводит клавиши и прикладывает скриншоты. Запускается по просьбе проверить TUI. CX Codex ★ 1 596звёзд репо ratatui-tui blacktop Скилл ratatui-tui для Claude Code и ещё пяти агентных сред: собирает терминальные интерфейсы на ratatui 0.30.1. Подсказывает архитектуру Elm, виджеты, async-обработку событий и стили по правилам Rust 2026. CX Codex +1 959установок

Из того же набора96

Весь набор →
tailwindcss-responsive-darkmode Скилл tailwindcss-responsive-darkmode по Tailwind CSS: адаптивная вёрстка, тёмная тема, переключение на лету и защита от вспышки нестилизованного контента. CX Codex +1 480установок bash-master Скилл bash-master помогает писать и проверять Bash-скрипты с учётом ShellCheck, защитных флагов и совместимости с Linux, macOS, WSL и контейнерами. CX Codex +1 464установок context-master Скилл context-master для планирования сложных задач и многофайловых проектов. Заставляет агента сначала составить план, а потом писать файлы. CX Codex +1 401установок tailwindcss-fundamentals-v4 Скилл tailwindcss-fundamentals-v4 для Claude Code: справочник по Tailwind CSS v4 — установка, настройка через @theme, миграция с v3 и новые утилиты. Переводит проект с v3 на v4. CX Codex +1 398установок tailwindcss-accessibility Скилл tailwindcss-accessibility для Claude Code помогает создавать доступные интерфейсы на Tailwind CSS. Активируется при работе с WCAG, фокусом, контрастом и ARIA. CX Codex +1 302установок tailwindcss-framework-integration Скилл tailwindcss-framework-integration помогает настроить Tailwind CSS в проектах на React, Vite, Next.js, Vue, Nuxt и SvelteKit. Пригодится при подключении плагинов сборщика, тёмной темы и слиянии классов. CX Codex +1 298установок ffmpeg-color-grading-chromakey Скилл ffmpeg-color-grading-chromakey для Claude Code содержит фильтры FFmpeg для удаления хромакея, применения LUT и цветокоррекции видео при автоматизации монтажа ИИ-агентами. CX Codex +1 284установок tailwindcss-advanced-components Скилл tailwindcss-advanced-components для Claude Code помогает собирать варианты React-компонентов на Tailwind CSS с CVA, compound variants и cn. Описывает паттерны в стиле shadcn/ui. CX Codex +1 253установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой