mcpField
T
textual-tui-skill

textual-tui-skill

github.com/podoDevelopment29213 installsUpdated 1d ago
Repository

About textual-tui-skill

A Textual framework reference skill for Python developers building terminal user interfaces. It covers widgets, layouts, styling, asynchronous tasks, and testing, and includes four example apps.

Key features

  1. 01Textual widget and layout reference
  2. 02TCSS styling and reactive attributes
  3. 03Async workers and thread-safe updates
  4. 04Multi-screen navigation and event handling
  5. 05Pilot API and pytest testing patterns
  6. 06Four complete example apps

Use cases

  1. 01Build Python terminal interface applications
  2. 02Add responsive layouts and styling to interfaces
  3. 03Handle long-running tasks and update the UI
  4. 04Simulate UI interactions with pytest

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/podo/design-agent-skills --skill textual-tui-skill

After installing, type/textual-tui-skillin Claude Code to confirm it loaded.

Bundled filesstub.yaml

Details

From the project README

textual-tui-skill

Catalogue stub — full skill: aperepel/textual-tui-skill (textual-tui)

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:

    [ -e ~/.agents/skills/textual-tui-skill ] && echo "global" || echo "project"

    Global:

    npx skills add aperepel/textual-tui-skill --skill textual-tui -g -y

    Project:

    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

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:

AreaCoverage
WidgetsBuilt-in widgets such as Input, Button, Select, Checkbox, DataTable, Tree, Log, RichLog, Tabs, TabbedContent
LayoutsVertical, Horizontal, Grid; fixed/fractional sizing; responsive patterns
StylingTCSS syntax, semantic color system, external stylesheets, borders, padding
ReactivityReactive attributes, watchers, computed properties, DOM-like widget tree
AsyncWorkers for long-running tasks, call_from_thread() for thread-safe UI updates, cancellation
NavigationMulti-screen apps, modal screens, screen stack management
EventsMount, Click, Key; keyboard bindings; action methods; message propagation
TestingPilot API, async test patterns with pytest, UI interaction simulation
PitfallsCommon 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

Comments

Markdown supported