How do I install the Textual Tui Skill skill?

Run npx skillmds@latest add podo/textual-tui-skill in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Textual Tui Skill safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Textual Tui Skill?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Textual Tui Skill free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Textual Tui Skill?

podo (@podo) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Textual Tui Skill by podo — Agent Skill

Name: Textual Tui Skill
Rating: 4.666666666666667 (3 reviews)
Author: podo

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.

podo Updated Sep 9, 2026

File contents

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

--- name: textual-tui-skill description: | 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. triggers: - "Textual TUI" - "textual-tui-skill" - "Textual widget" - "Textual app" - "TCSS styling" - "Textual framework" das: type: package category: tui-terminal upstream: "https://github.com/aperepel/textual-tui-skill" version: latest --- # textual-tui-skill > Catalogue stub — full skill: [aperepel/textual-tui-skill](https://github.com/aperepel/textual-tui-skill) ## Install the full skill ```bash # 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: ```bash # 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`

Frequently asked questions