Catalogue stub — full skill: aperepel/textual-tui-skill
Install the full skill
# Clone and run quickstart
git clone https://github.com/aperepel/textual-tui-skill
cd textual-tui-skill
bash quickstart.sh
Or install the pre-compiled skill file directly into your agent's skills directory:
# Global
curl -o ~/.agents/skills/textual-tui-skill/SKILL.md \
https://raw.githubusercontent.com/aperepel/textual-tui-skill/main/skill/SKILL.md
curl -o .agents/skills/textual-tui-skill/SKILL.md
https://raw.githubusercontent.com/aperepel/textual-tui-skill/main/skill/SKILL.md
## What it does
Comprehensive Textual framework reference for building professional Python TUIs:
| Area | Coverage |
|------|----------|
| **Widgets** | 40+ built-in: 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** | 10 common mistakes documented: blocking event loop, thread safety, worker selection |
4 complete working example apps (~1,100 lines): todo app, system dashboard, data viewer, 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`