ratatui-tui — скилл для Claude Code: TUI на Rust
Помогает агенту писать терминальные интерфейсы на ratatui: шаблоны проектов, виджеты, раскладка, асинхронные события. Пригодится, если делаете TUI на Rust.
npx skills add blacktop/dotfiles --skill ratatui-tui -a claude-codeЧто делает ratatui-tui
Скилл описывает, как собирать терминальные приложения на ratatui версии 0.30.x. Внутри — шаблоны проектов разной сложности: от hello-world для первых опытов до component-app с несколькими экранами, конфигом и логированием. Есть отдельный async-app для фоновых задач и работы с сетью. Шаблон копируется в проект или генерируется через cargo generate ratatui/templates.
Основная архитектура — Elm Architecture: модель, сообщение, обновление, отрисовка. Скилл показывает StatefulWidget для списков и таблиц, раскладку через Layout::vertical и Layout::horizontal, встроенные типы состояния вроде ListState и TableState. Для асинхронных событий — EventStream из crossterm вместе с tokio::select!. Отдельно разобраны картинки через ratatui-image 11.x и анимация загрузки через tui-shimmer.
Есть раздел про переезд с 0.29: block::Title убрали, layout::Alignment переименовали в HorizontalAlignment, а Flex::SpaceAround теперь ведёт себя как во flexbox. Если отключить default-features у ratatui, вместе с ними уйдёт layout-cache — производительность раскладки просядет, так что кэш придётся включать обратно вручную. Это повод проверить Cargo.toml перед релизом. Для сборки нужен Rust с MSRV 1.88 и edition 2024.
Какие задачи решает
- поднять новый TUI-проект на ratatui с готовым шаблоном
- добавить список или таблицу с состоянием выделения
- развести экран на зоны через Layout
- обработать клавиатуру и фоновые события в одном цикле
- починить раскладку после перехода с 0.29 на 0.30
Примеры запросов агенту
- Создай новый TUI-проект на ratatui из шаблона simple-app
- Добавь в приложение таблицу с прокруткой через TableState
- Перепиши цикл событий на EventStream и tokio::select!
Как установить ratatui-tui
1Через Skills CLI (Vercel)
npx skills add blacktop/dotfiles --skill ratatui-tui -a claude-code2Вручную: положить файлы
~/.claude/skills/ratatui-tui/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ratatui-tui/
1Через Skills CLI (Vercel)
npx skills add blacktop/dotfiles --skill ratatui-tui -a codex2Вручную: положить файлы
.agents/skills/ratatui-tui/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add blacktop/dotfiles --skill ratatui-tui -a cursor2Вручную: положить файлы
.cursor/skills/ratatui-tui/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install blacktop/dotfiles ratatui-tui2Вручную: положить файлы
.github/skills/ratatui-tui/SKILL.md1Через Skills CLI (Vercel)
npx skills add blacktop/dotfiles --skill ratatui-tui -a gemini-cli2Командой платформы
gemini skills install https://github.com/blacktop/dotfiles --path ai/skills/ratatui-tuiВручную: положить файлы
.devin/skills/ratatui-tui/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add blacktop/dotfiles --skill ratatui-tui -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о ratatui-tui
Как установить ratatui-tui в Claude?
Выполните npx skills add blacktop/dotfiles --skill ratatui-tui -a claude-code. Скилл появится по пути ~/.claude/skills/ratatui-tui/SKILL.md.
Что делает ratatui-tui?
Даёт агенту инструкции по сборке терминальных интерфейсов на ratatui 0.30.x: шаблоны, виджеты, раскладка, асинхронные события, картинки и анимация загрузки.
Какая версия ratatui поддерживается?
Целевая ветка — 0.30.x, минимальная версия Rust 1.88 и edition 2024. Для актуального патча скилл советует выполнить cargo info ratatui.
