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.

referencespackaging-and-ci.md

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

Packaging and CI

Use this file when the user wants something that can be installed, run, or tested like a normal Python project.

Baseline project shape

  • my_app.py or a package module
  • matching .tcss
  • tests/
  • pyproject.toml
  • optional .github/workflows/textual-tests.yml

Recommended dependencies

Runtime:

  • textual

Useful dev dependencies:

  • pytest
  • pytest-asyncio
  • textual-dev
  • pytest-textual-snapshot

Optional:

  • syntax extras when the app needs TextArea syntax support

Console entry points

Prefer a main() function and a package/script entry in pyproject.toml.

CI guidance

A good default workflow should:

  • test multiple Python versions where sensible
  • install the project with dev extras
  • run pytest
  • upload snapshot artefacts if present

Use the bundled generators:

  • python scripts/emit_textual_pyproject.py
  • python scripts/emit_github_actions_ci.py

Packaging checklist

Before finishing:

  • entry point works
  • tests are runnable with pytest
  • the README or handoff notes mention textual run --dev
  • the project structure is understandable without reading a long explanation

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