TUI Design System

Standardizes themes, layouts, navigation, and interactive UX patterns for Textual TUI screens.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/benmaier/decision-agent-placeholder --skill tui-design-system
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: TUI Design System
Source: https://github.com/benmaier/decision-agent-placeholder/tree/main/.claude/skills/tui-design
Command: npx skills add https://github.com/benmaier/decision-agent-placeholder --skill tui-design-system

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Visual language and UX patterns unify Textual TUI applications, reducing design drift and onboarding time across the project.

Core Features & Use Cases

  • Theme & Layout: standardizes theme, alignment, container dimensions, and chrome usage.
  • Accent Blocks: applies consistent left-border accents and surface backgrounds to interactive elements.
  • Checkboxes: provides consistent checkbox styling and keyboard navigation behavior.
  • Navigation: defines arrow key bindings and Tab behavior to ensure predictable focus management.
  • Typography: prescribes step indicators, labels, hints, errors, and dividers for readability.
  • Buttons: uniform button styling with hover states and consistent sizing.
  • Patterns: collision detection and creation flow guardrails for robust UX.
  • Color Palette: monokai-inspired palette for main UI elements and feedback colors.

Quick Start

Follow these patterns when designing or updating Textual TUI screens to ensure consistent visuals and behavior.

Frequently Asked Questions about TUI Design System

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I standardize typography and navigation in Textual TUI apps?

Standardize Textual TUI typography and navigation by applying cohesive UI patterns for step indicators, labels, arrow key bindings, and Tab focus management. This ensures predictable keyboard behavior and visual consistency across all application screens.

What is the best way to prevent design drift in Textual TUI applications?

Prevent design drift in Textual TUI applications by enforcing a structured design system that unifies visual language, theme alignment, chrome usage, and button styling. This reduces onboarding time and maintains consistent interactive elements.

Does this TUI design system support custom themes and color palettes?

This TUI design system supports custom themes by applying a monokai-inspired color palette for main UI elements and feedback. It standardizes container dimensions, surface backgrounds, and left-border accents for interactive elements.

How do I manage focus and keyboard navigation in Textual TUI screens?

Manage focus and keyboard navigation in Textual TUI screens using defined arrow key bindings and Tab behavior. The design system prescribes consistent checkbox styling and collision detection patterns to ensure robust focus management.

Can I use this design system for complex Textual TUI creation flows?

You can use this design system for complex Textual TUI creation flows because it defines collision detection and creation flow guardrails. These patterns ensure robust UX when designing or updating interactive Textual screens.

What metadata schema is required for Textual TUI design system discovery?

Textual TUI design system discovery requires a YAML frontmatter with name and description fields. It supports optional directories for scripts, references, and assets, defining a structured metadata schema for safety and project organization.