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.

referencestesting-matrix.md

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

Testing matrix

Treat tests as part of the deliverable, not optional polish.

Default minimum

For any non-trivial feature, leave behind:

  1. Smoke test
    App launches under run_test().

  2. Behaviour test
    The user interaction that changed actually works.

  3. Layout or size test
    Use an alternate terminal size when the layout matters.

  4. Snapshot test
    Add one when the feature is visually structured and regressions are likely.

Pilot-first testing

Use run_test() and Pilot for:

  • press(...)
  • click(...)
  • filling inputs
  • pausing for async work
  • asserting widget state

Good behaviour tests:

  • typing into a filter updates results
  • selecting a row updates a detail pane
  • pressing a binding changes mode/screen
  • a save action updates status and notifies

Snapshot tests

Use snapshot tests when:

  • TCSS and layout are important
  • the app has multiple panes
  • narrow vs wide layouts matter
  • a refactor might silently change structure

Useful variations:

  • alternate terminal sizes
  • initial key presses
  • a small setup callback before capture

Layout-sensitive features

Always consider a second size when the app has:

  • side panes
  • breakpoints
  • content switchers
  • long forms
  • data tables
  • browser support

Test-writing guidance

  • give important widgets stable IDs
  • avoid selectors based on display text when IDs or classes are better
  • test through user actions rather than internal methods when possible
  • pause for worker completion in the smallest reliable way
  • keep one smoke test even if snapshot coverage exists

Good output for a skill-driven change

  • a passing smoke test
  • a focused behaviour test
  • a comment or docstring only where behaviour is subtle
  • snapshot coverage only where it earns its keep

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