textual-tui-skill — скилл для Claude Code: Textual и установка
Скилл textual-tui-skill помогает собирать терминальные интерфейсы на Python с Textual: от виджетов и стилей до экранов, фоновых задач и тестов.
MIT 268 установок ★ 35 обновлён 2026-10-21
npx skills add podo/design-agent-skills --skill textual-tui-skill -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/textual-tui-skill/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/textual-tui-skill/
1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill textual-tui-skill -a codex2Вручную: положить файлы
.agents/skills/textual-tui-skill/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill textual-tui-skill -a cursor2Вручную: положить файлы
.cursor/skills/textual-tui-skill/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/textual-tui-skill2Вручную: положить файлы
.github/skills/textual-tui-skill/SKILL.md1Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill textual-tui-skill -a gemini-cli2Командой платформы
gemini skills install https://github.com/podo/design-agent-skills --path skills/textual-tui-skillВручную: положить файлы
.devin/skills/textual-tui-skill/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill textual-tui-skill -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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