claudeers.
// Claude Skills

tui-design-skill

Production-grade AI skill for designing and building polished terminal UIs — Bubble Tea, Textual, Ratatui, and Ink. Works with Claude Code, OpenCode, Codex,…

// Claude Skills[ cli ][ api ][ web ][ mobile ][ claude ]#claude#agent-skills#ai-skill#bubbletea#claude-code#claude-plugin#cli#codex#skills◷ MIT$open-sourceupdated about 7 hours ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up tui-design-skill (git-clone project) into my current project.
Found on https://claudeers.com/tui-design-skill-2
Repo: https://github.com/pageton/tui-design-skill
Homepage/docs: https://skills.sh/pageton/tui-design-skill
Detected install method: git-clone → git clone https://github.com/pageton/tui-design-skill
Category: skills. Platforms: cli, api, web, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/pageton/tui-design-skill

// compatibility

Platformscli, api, web, mobile
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

TUI Design Skill

skills.sh

A production-grade AI skill for designing and building exceptionally polished terminal user interfaces. Works as an expert terminal product designer and senior TUI engineer — opinionated about good design, strong on architecture, and focused on making terminal apps feel modern and delightful.

What It Does

  • Generate new TUI apps from a product idea
  • Convert CLI workflows into interactive TUIs
  • Redesign existing TUIs to feel modern and polished
  • Review TUI code with a scored UX assessment
  • Recommend frameworks, patterns, and components
  • Handle Unicode/RTL text, terminal compatibility, and testing correctly

The pack uses progressive disclosure: SKILL.md carries the workflow and standards, and the references, framework guides, screen patterns, runnable starters, and example apps behind them load on demand — the agent never needs all of that context at once.

When It Triggers

Once installed, the skill activates on its own — no slash command required — when a conversation touches:

  • Building a TUI ("build me a log viewer", "create a server-health dashboard")
  • Converting a CLI tool into an interactive terminal app
  • Redesigning or reviewing an existing TUI's design, UX, or code
  • Choosing a framework ("Bubble Tea or Ratatui for a kanban app?")
  • Text rendering — Unicode, wide characters, emoji, RTL/Arabic/Hebrew, alignment bugs
  • Terminal reality — tmux/SSH, color support, mouse, resize, snapshot and interaction tests

It stays out of web UI, native GUI, and backend work that involves no terminal interface.

Install

Install each agent once — the Claude Code plugin or the skills pack for that agent, not both. Mixing them duplicates the skill and can leave two copies drifting apart.

Claude Code

Installed as a plugin, through the normal marketplace mechanism. No manual file copying.

1. Add this repo as a marketplace:

/plugin marketplace add pageton/tui-design-skill

2. Install the plugin:

/plugin install tui-design

3. Invoke with:

/tui-design Build me a dashboard for monitoring server health

Or just describe a TUI task in conversation — the skill triggers automatically.

To test a local checkout before publishing, run Claude Code with --plugin-dir pointed at the repo:

claude --plugin-dir ~/Projects/tui-design-skill

Other agents (OpenCode, Codex, ZCode, …)

The pack works with any tool that follows the Agent Skills specification. Install it from skills.sh — the open agent-skills directory — with the skills CLI.

Listed on skills.sh at pageton/tui-design-skill. One command auto-detects your installed agents (OpenCode, Codex, ZCode, Cursor, …) and installs for all of them:

npx skills add pageton/tui-design-skill

The CLI (vercel-labs/skills) symlinks the pack into each agent's skills directory, so one update flows to every agent at once:

# Global install (available in all projects) for specific agents
npx skills add pageton/tui-design-skill -g -a opencode -a codex -a zcode

# Non-interactive (CI friendly)
npx skills add pageton/tui-design-skill -g -y

# See what is installed; pull the latest version for every detected agent
npx skills list
npx skills update

If a flag or command is rejected (unknown command / unknown option), npx resolved a stale cached CLI — pin the latest with npx skills@latest add pageton/tui-design-skill.

The skill activates automatically in every installed agent — no slash command needed. If you want an explicit entry point anyway, thin router commands ship in the repo under opencode/commands/, codex/commands/, and zcode/commands/; copy the one for your tool into its command directory. The Claude Code plugin includes its router already.

Updating

  • Claude Code plugin: marketplace plugins keep themselves current; use /plugin to check or manage the installed version.
  • Skills CLI installs: npx skills update — symlinked packs pick up the latest version for every detected agent.
  • Manual copies (legacy): delete the copied tui-design/ directory and reinstall with npx skills add pageton/tui-design-skill.

Agent Compatibility

The skill files (SKILL.md, references/, frameworks/, patterns/) are plain Agent Skills markdown with no agent-specific content, so they load verbatim everywhere. Only the entry point differs per tool.

AgentSkill auto-triggerEntry pointInstall
Claude Codeyes/tui-designplugin (marketplace)
OpenCodeyes/tui-designskills pack (skills CLI)
Codexyes/prompts:tui-designskills pack (skills CLI)
ZCodeyes/tui-designskills pack (skills CLI)
Other Agent Skills toolsif supportedn/askills pack

just check-compatibility enforces the split: agent names, harness syntax, and install paths are banned inside the skill pack; the four command files stay thin, portable routers.

What's Included

tui-design-skill/
├── .claude-plugin/
│   ├── plugin.json                   # Claude Code plugin manifest
│   └── marketplace.json              # Lets this repo self-host as a marketplace
├── AGENTS.md                         # Editing constraints for AI coding agents
├── commands/
│   └── tui-design.md                 # Claude Code plugin slash command
├── opencode/
│   └── commands/
│       └── tui-design.md             # OpenCode slash command
├── codex/
│   └── commands/
│       └── tui-design.md             # Codex slash command
├── zcode/
│   └── commands/
│       └── tui-design.md             # ZCode slash command
├── skills/
│   └── tui-design/
│       ├── SKILL.md                  # Main skill definition
│       ├── references/               # Design reference documents
│       │   ├── design-principles.md          # Visual hierarchy, spacing, layout
│       │   ├── architecture-patterns.md      # State management, components, async
│       │   ├── framework-selection.md        # Framework trade-off matrix + decision rules
│       │   ├── terminal-compatibility.md     # Terminal capability matrix + fallbacks
│       │   ├── unicode-and-text.md           # Display width, Unicode cases and tests
│       │   ├── rtl-and-bidi.md               # Arabic/RTL logical-vs-visual rules
│       │   ├── testing-tuis.md               # Unit/snapshot/interaction/Unicode tests
│       │   ├── troubleshooting.md            # Symptom → layer attribution → fix
│       │   ├── interaction-guide.md          # Keybindings, focus, navigation
│       │   ├── component-catalog.md          # 14 component patterns with mockups
│       │   ├── color-and-emphasis.md         # Palette strategy, terminal compat
│       │   ├── states-and-feedback.md        # Empty/loading/error state patterns
│       │   ├── advanced-patterns.md          # Grids, pagination, filtering, theming
│       │   ├── stability-and-robustness.md   # Resize, panics, async safety, backpressure
│       │   └── review-checklist.md           # 10-category scored UX review
│       ├── frameworks/               # Framework-specific guides
│       │   ├── bubbletea-go.md               # Go + Bubble Tea + Lip Gloss
│       │   ├── textual-python.md             # Python + Textual
│       │   ├── ratatui-rust.md               # Rust + Ratatui + Crossterm
│       │   └── ink-react.md                  # TypeScript + Ink + React
│       ├── patterns/                 # Screen patterns with ASCII layouts
│       │   ├── dashboard.md
│       │   ├── data-browser.md
│       │   ├── database-browser.md           # dbview-style multi-view data tool
│       │   ├── form-workflow.md
│       │   ├── log-viewer.md
│       │   └── file-explorer.md
│       ├── templates/                # Runnable starter apps
│       │   ├── bubbletea-starter/main.go
│       │   ├── textual-starter/app.py
│       │   ├── ratatui-starter/
│       │   │   ├── Cargo.toml
│       │   │   └── src/main.rs
│       │   └── ink-starter/
│       │       ├── package.json
│       │       ├── package-lock.json
│       │       ├── tsconfig.json
│       │       └── src/main.tsx
│       └── projects/                 # Complete runnable example apps
│           ├── dbview-go/                    # Advanced data browser (Bubble Tea)
│           │   ├── main.go                   #   model, view stack, layout math
│           │   ├── update.go                 #   key routing: modal > input > view
│           │   ├── store.go                  #   typed filter/sort/paginate domain
│           │   ├── view.go                   #   grid, status bar, modals, themes
│           │   ├── theme.go                  #   runtime-switchable palettes
│           │   └── *_test.go                 #   logic + render smoke tests
│           └── log-monitor-rust/             # Resilient log streamer (Ratatui)
│               ├── src/main.rs               #   panic-safe terminal guard + loop
│               ├── src/app.rs                #   input model (unit-tested)
│               ├── src/color.rs              #   color tier ladder (unit-tested)
│               ├── src/ring.rs               #   bounded buffer w/ drop accounting
│               ├── src/stream.rs             #   simulated producer
│               └── src/ui.rs                 #   stats, viewport, banners
├── CHANGELOG.md                       # Release history (semver)
├── evals/                             # Skill evaluation scenarios
│   ├── README.md                      # How to run and record evals
│   ├── new-tui-app.md                 # Greenfield TUI generation rubric
│   ├── cli-to-tui.md                  # Conversion that keeps CI working
│   ├── rtl-arabic.md                  # Arabic/RTL handling rubric
│   ├── unicode-width.md               # Display-width alignment rubric
│   ├── rendering-bug.md               # tmux/SSH/restore troubleshooting
│   └── framework-selection.md         # Requirement-driven decision rubric
├── scripts/
│   ├── check-mockups.py              # ASCII mockup alignment checker
│   ├── check-crossrefs.py            # Cross-reference sync checker
│   ├── check-evals.py                # Eval scenario skeleton/coverage checker
│   ├── check-install.py              # Install-docs simulation checker
│   ├── check-compatibility.py        # Agent-agnostic pack checker
│   ├── test_check_crossrefs.py       # Unit tests for check-crossrefs.py
│   ├── test_check_evals.py           # Unit tests for check-evals.py
│   ├── test_check_install.py         # Unit tests for check-install.py
│   └── test_check_compatibility.py   # Unit tests for check-compatibility.py
└── justfile                          # Validation pipeline (just check-all)

Development

No build step — the repo is Markdown plus starter templates, validated with just:

just check-all            # everything below
just check-mockups        # ASCII mockup alignment only
just check-crossrefs      # SKILL.md/README/command/manifest sync only
just check-evals          # eval scenario skeleton, coverage, reference paths
just check-install        # simulate documented installs into a temp $HOME
just check-compatibility  # skill pack stays agent-agnostic
just test-scripts         # unit tests for the validation scripts

check-all enforces the repo's own quality rules: every ASCII mockup must render at a fixed width (a misaligned mockup is worse than no mockup — see AGENTS.md), markdown must lint clean, the Bubble Tea, Ratatui, and Textual templates must compile, and the example projects must compile and pass their unit tests. check-crossrefs keeps the pack honest about its own structure: every reference, framework, and pattern file must be listed in SKILL.md's Reference Documents and in the README tree, the four per-tool command files must be byte-identical, and the plugin manifests must point at real paths. check-install actually runs the documented manual-install commands against a temp $HOME and verifies what lands. check-compatibility bans agent-specific content inside the skill pack. The validation scripts have unit tests (just test-scripts). Each starter also runs directly:

cd skills/tui-design/templates/bubbletea-starter && go run main.go
cd skills/tui-design/templates/textual-starter   && textual run app.py --dev
cd skills/tui-design/templates/ratatui-starter   && cargo run
cd skills/tui-design/templates/ink-starter       && npm install && npm start

Skill Quality

The skill is measured, not assumed. evals/ holds six graded scenarios (greenfield TUI, CLI-to-TUI conversion, Arabic/RTL, Unicode width, rendering troubleshooting, framework selection); each run executes the scenarios with the skill loaded, grades the responses blind against the rubrics, and records results in evals/README.md.

Verified results (GLM-5.3, blind grading, identical prompts and fixtures):

  • With skill 96.9% rubric score (31.0/32), zero fail signals (run 3, this release) vs 85.9% baseline without the skill (run 1) — the delta is the skill's measured contribution.
  • Cross-model (Codex CLI 0.157.1, gpt-6-luna, same scenarios and rubrics): 81.2% — the skill's guidance transferred (capability detection, README deliverables, and all-axes comparisons all passed on the second model); the score gap is execution depth (fewer tests, minimal diffs in exec mode), not concept errors.
  • Iterated fixes verified by graders reading the generated code: the 256-color tier, cursor-show terminal restore, TMUX/TERM_PROGRAM detection, README-as-file deliverables, and full-axis framework comparisons all appear in the evaluated output.

Known limitations are recorded alongside the results in evals/README.md.

Example Projects

Beyond the minimal starters, skills/tui-design/projects/ contains complete apps that show how the references hold up in real code:

ProjectStackFocus
dbview-goGo + Bubble Tea + Lip GlossAdvanced data-app patterns: multi-view stack, pagination, typed sorting, live AND-filtering with history, confirm-before-delete, theme cycling — modeled on dbview
log-monitor-rustRust + Ratatui + CrosstermStability: backpressure with drop accounting, pause/resume, disconnect/retry, panic-safe terminal restore, min-size gate

Both ship unit tests that verify the stability contract without a TTY (just check-go-project, just check-rust-project).

Example Prompts

Build:

  • Build me a beautiful TUI for browsing database records
  • Build a dbview-style database explorer with sorting, filtering, and query history
  • Create a dashboard-style terminal UI with panels and keyboard navigation
  • Generate a clean multi-pane log viewer TUI
  • Design a gorgeous terminal file explorer

Convert:

  • Turn this CLI deployment tool into a polished interactive TUI

Redesign:

  • Redesign this Bubble Tea app so it feels premium
  • Make this admin TUI less ugly and more modern

Review:

  • Review my Textual app and make the UX much better

Decide:

  • Bubble Tea, Textual, Ratatui, or Ink for a real-time log dashboard — and why?

Design Philosophy

The skill is opinionated about these defaults:

  • Start monochrome — add color only where it earns its place
  • Generous spacing — tight spacing signals amateur design
  • Keyboard-first — all actions reachable via keyboard, with visible key hints
  • Designed states — empty, loading, error, and interactive states are never afterthoughts
  • Composable architecture — separate domain, state, and view logic
  • Responsive — handle terminal resize gracefully, define minimum sizes

Framework Support

FrameworkLanguageBest For
Bubble Tea + Lip GlossGoDevOps tools, CLIs, single-binary utilities
TextualPythonData tools, dashboards, admin panels
Ratatui + CrosstermRustHigh-performance tools, long-running monitors
Ink + ReactTypeScriptInteractive CLIs, dev tools, JS-native workflows

License

MIT — see LICENSE.

// faq

What is tui-design-skill?

Production-grade AI skill for designing and building polished terminal UIs — Bubble Tea, Textual, Ratatui, and Ink. Works with Claude Code, OpenCode, Codex, ZCode, and any Agent Skills tool.. It is open-source on GitHub.

Is tui-design-skill free to use?

tui-design-skill is open-source under the MIT license, so it is free to use.

What category does tui-design-skill belong to?

tui-design-skill is listed under skills in the Claudeers registry of Claude-compatible tools.

0 views
★ 33 stars
unclaimed
updated about 7 hours ago

// embed badge

tui-design-skill on Claudeers
[![Claudeers](https://claudeers.com/api/badge/tui-design-skill-2.svg)](https://claudeers.com/tui-design-skill-2)

// retro hit counter

tui-design-skill hit counter
[![Hits](https://claudeers.com/api/counter/tui-design-skill-2.svg)](https://claudeers.com/tui-design-skill-2)

// reviews

// guestbook

0/500

// related in Claude Skills

🔓

An agentic skills framework & software development methodology that works.

// skillsobra/⟨Shell⟩★ 314,126◷ MIT[ claude ]
🔓

Public repository for Agent Skills

// skillsanthropics/⟨Python⟩★ 188,182[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// skillsGraphify-Labs/⟨Python⟩★ 149,064◷ MIT[ claude ]
🔓

💫 Toolkit to help you get started with Spec-Driven Development

// skillsgithub/⟨Python⟩★ 148,200◷ MIT[ claude ]
→ see how tui-design-skill connects across the ecosystem