textual-tui-skill
Deep-dive Textual (Python) TUI skill — 40+ widgets, layout systems, TCSS styling, reactive programming, background workers, multi-screen navigation, modal dialogs, and testing via Pilot API. Covers 10 common pitfalls and thread-safety rules for async/worker patterns. v1.0.0.
How do I install this agent skill?
npx skills add https://github.com/podo/design-agent-skills --skill textual-tui-skillIs this agent skill safe to install?
- Gen Agent Trust Hubwarn
The skill instructs the user to download and execute an unverified shell script from a community GitHub repository.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
textual-tui-skill
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
# Project
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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/podo/design-agent-skills/textual-tui-skill">View textual-tui-skill on skillZs</a>