Index of every page on this site: llms.txt
All skills
tristanmanchester avatar

/textual-tui

@3323bc9
by Tristan Manchestertristanmanchester/agent-skills3 stars
2
Run it yourself

Build, debug, test, or package Python Textual terminal interfaces: screens, widgets, TCSS, reactive state, workers, keyboard workflows, and optional browser delivery. Use when Textual is selected or an existing Textual app is involved; do not turn a noninteractive CLI or simple Rich output into a TUI unnecessarily.

Use this Skill: https://skilld.dev/gh/tristanmanchester/agent-skills/textual-tui

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesrepo-map.md

≈395 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Repository map

This summary was generated from the bundled Textual repository snapshot used to build this skill.

High-value directories

  • src/textual/ — framework source.
  • src/textual/widgets/ — built-in widgets (45 widget implementation files detected).
  • examples/ — standalone example apps worth mining for architecture and styling patterns.
  • docs/examples/ — guide/tutorial examples, usually minimal and focused on one concept.
  • tests/ — excellent source of behaviour contracts and edge-case handling.

docs/examples hot spots

  • guide — 158 files
  • styles — 145 files
  • widgets — 89 files
  • how-to — 29 files
  • app — 15 files
  • tutorial — 11 files
  • events — 7 files
  • themes — 3 files
  • getting_started — 1 files

tests hot spots

  • snapshot_tests — 606 files
  • css — 18 files
  • input — 12 files
  • text_area — 12 files
  • tree — 12 files
  • command_palette — 10 files
  • option_list — 10 files
  • animations — 7 files
  • select — 6 files
  • document — 5 files
  • layouts — 5 files
  • renderables — 5 files
  • selection_list — 5 files
  • listview — 4 files
  • notifications — 4 files
  • toggles — 4 files
  • suggester — 3 files
  • workers — 3 files
  • directory_tree — 2 files
  • __init__.py — 1 files

Practical search order

  1. Look in examples/ for full app structure.
  2. Look in docs/examples/guide/ for the smallest focused example of a feature.
  3. Look in tests/ when behaviour, edge cases, or event names are unclear.

Source: SKILL.md on GitHub

Skill behaviors

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

Third-party checks

1 warning1mo4 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The skill provides developer tools for Textual TUI development, including scaffolding and auditing. It uses dynamic Python code loading to analyze local projects, which presents a localized execution risk for the agent's environment.

  • Socket1mo

    1 alert: gptAnomaly

  • Snyk1mo

    Risk: LOW · No issues

  • ZeroLeaks6mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 3323bc9. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 weeks ago.

Steadyupdated last month

Capability

metadata
{
  "version": "3.0.0",
  "reviewed": "2026-09-13"
}
Other metadata
compatibility
Textual currently supports Python >=3.9,<4. Use the project's locked Textual and developer-tool versions. Bundled scaffold checks parse source without importing the generated application; runtime tests need Textual and the app's dependencies.

README badge

README badge for tristanmanchester/agent-skills/textual-tui