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

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

Скилл textual-tui-skill помогает собирать терминальные интерфейсы на Python с Textual: от виджетов и стилей до экранов, фоновых задач и тестов.

MIT 268 установок ★ 35 обновлён 2026-10-21

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

Что делает textual-tui-skill

Скилл даёт справочные материалы по Textual и помогает проектировать TUI на Python. Он охватывает встроенные виджеты, вертикальные, горизонтальные и сеточные раскладки, стили TCSS, реактивные атрибуты, обработчики событий и переходы между экранами. Есть примеры модальных окон и тестирования через Pilot API.

Внутри находятся материалы в references/ и четыре готовых приложения в assets/: список дел, системная панель, просмотрщик данных и демонстрация фонового исполнителя. Отдельно разобраны блокировка цикла событий и безопасное обновление интерфейса из потока. Для запуска сгенерированного кода нужны Python, textual и textual-dev; без этих пакетов приложения не запустятся.

Какие задачи решает

  • подобрать виджеты для терминального интерфейса на Textual
  • разложить элементы TUI по сетке или колонкам
  • оформить приложение с помощью TCSS
  • организовать фоновые задачи и обновления интерфейса из потока
  • проверить взаимодействие с интерфейсом через Pilot API

Примеры запросов агенту

  • Помоги собрать приложение Textual с таблицей данных и переключением экранов.
  • Проверь, почему фоновая задача блокирует цикл событий в моём приложении Textual.
  • Напиши тест интерфейса Textual с Pilot API и pytest.

Как установить textual-tui-skill

1Через Skills CLI (Vercel)

npx skills add podo/design-agent-skills --skill textual-tui-skill -a claude-code

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

~/.claude/skills/textual-tui-skill/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о textual-tui-skill

Как установить textual-tui-skill в Claude Code?

Выполните npx skills add podo/design-agent-skills --skill textual-tui-skill -a claude-code. Файл скилла находится по пути ~/.claude/skills/textual-tui-skill/SKILL.md.

Что делает textual-tui-skill?

Он помогает создавать TUI на Textual: объясняет виджеты, раскладки, TCSS, реактивность, фоновые задачи, навигацию и тестирование через Pilot API.

Что нужно для запуска кода, который создаёт скилл?

Нужны Python и пакеты textual и textual-dev. Они требуются для запуска созданных приложений.

Исходный текст

SKILL.md · MIT
---
name: textual-tui-skill
description: |
  Deep-dive Textual (Python) TUI skill: built-in widgets, layout systems, TCSS styling,
  reactive programming, background workers, multi-screen navigation, modal dialogs, and
  testing via the Pilot API. Covers common pitfalls and thread-safety rules for
  async/worker patterns, with working example apps.
triggers:
  - "Textual TUI"
  - "textual-tui-skill"
  - "Textual widget"
  - "Textual app"
  - "TCSS styling"
  - "Textual framework"
das:
  type: skill
  category: tui-terminal
  upstream: "https://github.com/aperepel/textual-tui-skill"
  upstream_path: "skill/SKILL.md"
  version: latest
---

# textual-tui-skill

> Catalogue stub — full skill: [aperepel/textual-tui-skill](https://github.com/aperepel/textual-tui-skill) (`textual-tui`)

<!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block -->
## Decision tree

1. **Is the full skill already installed?**
   Upstream names this skill `textual-tui`, so it installs next to this pointer (the pointer is not replaced).
   - Global: `f=~/.agents/skills/textual-tui/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - Project: `f=.agents/skills/textual-tui/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - `installed` → the skill is installed as `textual-tui`, invoke it and proceed
   - `pointer` → go to step 2

2. **Detect scope, then install:**

   ```bash
   [ -e ~/.agents/skills/textual-tui-skill ] && echo "global" || echo "project"
   ```

   **Global:**
   ```bash
   npx skills add aperepel/textual-tui-skill --skill textual-tui -g -y
   ```

   **Project:**
   ```bash
   npx skills add aperepel/textual-tui-skill --skill textual-tui -y
   ```
   > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation.

**Heads-up**

- **Requires:** Python with textual and textual-dev (pip install textual textual-dev) to run what the skill generates
- **License:** MIT
<!-- das:install:end -->

## Invoke after install

- Skill name: `textual-tui`
- Trigger phrases: "Textual TUI", "Textual widget", "Textual app", "TCSS styling", "Textual framework"

## What it does

Comprehensive Textual framework reference for building professional Python TUIs:

| Area | Coverage |
|------|----------|
| **Widgets** | Built-in widgets such as Input, Button, Select, Checkbox, DataTable, Tree, Log, RichLog, Tabs, TabbedContent |
| **Layouts** | Vertical, Horizontal, Grid; fixed/fractional sizing; responsive patterns |
| **Styling** | TCSS syntax, semantic color system, external stylesheets, borders, padding |
| **Reactivity** | Reactive attributes, watchers, computed properties, DOM-like widget tree |
| **Async** | Workers for long-running tasks, `call_from_thread()` for thread-safe UI updates, cancellation |
| **Navigation** | Multi-screen apps, modal screens, screen stack management |
| **Events** | Mount, Click, Key; keyboard bindings; action methods; message propagation |
| **Testing** | Pilot API, async test patterns with pytest, UI interaction simulation |
| **Pitfalls** | Common mistakes documented: blocking the event loop, thread safety, worker selection |

Ships `references/` (widgets, layouts, styling, an index of the official guides) and four complete example apps under `assets/`: a todo app, a system dashboard, a data viewer and a worker demo.

## When NOT to use

- Multi-framework TUI overview (Go/Rust/Python/TS) — use `tui-design-skill`
- Bubble Tea (Go) — use `tui-design-skill`
- Ratatui (Rust) — use `tui-design-skill`
- Ink (TypeScript/React) — use `tui-design-skill`

© podo · MIT · podo/design-agent-skills

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

Все скиллы по теме «Фронтенд и UI» →
textual-builder YPares Скилл textual-builder помогает создавать терминальные интерфейсы на Textual и прототипировать карточные игры. Внутри есть документация по виджетам, раскладке, стилям и интерактивности. CX Codex +1 7установок tui-design hyperb1iss Скилл tui-design для Claude Code помогает проектировать интерфейсы терминальных приложений. Он включается при работе с раскладкой панелей, цветами, клавиатурной навигацией и виджетами. CX Codex +1 1 400установок tui-fundamentals JosiahSiegel Скилл tui-fundamentals для Claude Code помогает спроектировать TUI, выбрать фреймворк и проверить архитектуру терминального приложения. Описывает TUI для dashboard, REPL, wizard и интерактивного CLI. CX Codex +1 369установок tui-testing dominikmartn Скилл tui-testing для Claude Code настраивает модульные тесты для headless TUI в Warp. Запускает проверку интерфейсных элементов через отрисовку в строки символов. CX Codex +1 ★ 720звёзд репо tui-verify-change dominikmartn Скилл tui-verify-change для Claude Code запускает headless TUI Warp и читает отрисованный экран после изменений интерфейса, ввода или поведения. CX Codex +1 ★ 720звёзд репо codex-tui-proof Ben Cohen Плагин codex-tui-proof для Claude Code проверяет терминальные интерфейсы в браузере Codex: вводит клавиши и прикладывает скриншоты. Запускается по просьбе проверить TUI. CX Codex ★ 1 596звёзд репо

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

Весь набор →
antvis-chart-skills Скилл antvis-chart-skills для Claude Code создаёт графики, схемы и инфографику средствами AntV. Визуализирует данные и превращает текст в диаграммы. CX Codex +1 277установок figma-official-skills Скилл figma-official-skills для Claude Code переносит макеты в код, собирает дизайн-системы и связывает компоненты Figma с компонентами репозитория. CX Codex +1 271установок shadcn-ui Скилл учит агента искать, ставить и связывать компоненты shadcn/ui с учётом настроек репозитория. CX Codex +1 271установок deanpeters-pm-skills Скилл deanpeters-pm-skills для Claude Code, Codex и Cursor: девять техник продуктового менеджмента — customer journey map по NNGroup, Lean UX Canvas, opportunity-solution tree Терезы Торрес, proto-persona, user story mapping. CX Codex +1 270установок remotion Скилл remotion для Claude Code собирает видео из React-компонентов: сцены, spring-анимация и экспорт в MP4, WebM или GIF. CX Codex +1 265установок user-research-cookiy Скилл user-research-cookiy помогает планировать пользовательские исследования, составлять гайды интервью и анализировать расшифровки прямо в диалоге с агентом. CX Codex +1 264установок framer-motion-skills Пакет из пяти скиллов по Framer Motion: варианты, прокрутка, жесты, layout-переходы и связка с React и Next.js. Ставится одной командой, работает в Claude, Codex и Cursor. CX Codex +1 264установок wcag-ai-skill Скилл wcag-ai-skill для Claude Code превращает критерии WCAG 2.2 в требования и планы работ для дизайна, разработки, проверки доступности и документации. Помогает провести проект от требований до документации. CX Codex +1 244установок

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

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