Skip to main content
skill CX Codex

tui-design-skill — Claude Code skill: what it does, install

The tui-design-skill skill designs and reviews terminal UIs and CLIs for Go, Rust, Python, and TypeScript. Use it when an interface needs clear navigation and interaction.

MIT 215 installs ★ 35 updated 2026-10-21

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add podo/design-agent-skills --skill tui-design-skill -a claude-code
Open on GitHub

What tui-design-skill does

tui-design-skill guides the design, implementation, and review of terminal interfaces and command-line tools. It covers layout, color handling from true color to ANSI, keybinding conventions, focus behavior, and discoverability. The supported stacks are Go with Bubble Tea and Lipgloss, Rust with Ratatui, Python with Textual, and TypeScript with Ink.

A core skill file defines the shared workflow and rules, then loads a framework reference when the task calls for one. It covers full-screen TUIs, interactive prompts, and plain CLIs. It is a poor fit for argument parsing when the command has no interactive UI.

After installation, invoke the skill as tui-design. Its trigger phrases include “TUI design”, “terminal UI”, Bubble Tea, Ratatui, Textual Python, and Ink TypeScript. The project uses the MIT license.

What it helps with

  • design a full-screen TUI layout
  • choose a terminal color system
  • define keybinding and focus rules
  • make interactive controls discoverable
  • review a CLI across supported frameworks

Example prompts for the agent

  • Use tui-design to design a Go terminal UI with Bubble Tea and Lipgloss, including layout and keybindings.
  • Review this Ratatui interface for color use, focus behavior, and discoverability.
  • Build an interactive Python CLI with Textual and select suitable interface patterns.

How to install tui-design-skill

1Skills CLI (Vercel)

npx skills add podo/design-agent-skills --skill tui-design-skill -a claude-code

2Manually: put the files in place

~/.claude/skills/tui-design-skill/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tui-design-skill/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about tui-design-skill

How do I install tui-design-skill in Claude Code?

Run npx skills add podo/design-agent-skills --skill tui-design-skill -a claude-code, then check ~/.claude/skills/tui-design-skill/SKILL.md.

What does tui-design-skill do?

It helps create and review terminal UIs and CLIs. Its guidance covers layout, color systems, keybindings, focus, and framework patterns for Bubble Tea, Ratatui, Textual, and Ink.

Which frameworks does tui-design-skill cover?

It covers Go with Bubble Tea and Lipgloss, Rust with Ratatui, Python with Textual, and TypeScript with Ink. The installed skill is invoked as tui-design.

Source text

SKILL.md · MIT
---
name: tui-design-skill
description: |
  Designs, builds, and reviews clean, professional terminal UIs and CLIs across
  four ecosystems: Go (Bubble Tea/Lipgloss), Rust (Ratatui), Python (Textual),
  and TypeScript (Ink). Covers layout patterns, color systems, keybinding
  conventions, discoverability, and framework-specific design patterns.
triggers:
  - "TUI design"
  - "terminal UI"
  - "Bubble Tea"
  - "Ratatui"
  - "Textual Python"
  - "Ink TypeScript"
  - "tui-design-skill"
das:
  type: skill
  category: tui-terminal
  upstream: "https://github.com/gfargo/tui-design-skill"
  upstream_path: "plugins/tui-design/skills/tui-design/SKILL.md"
  version: latest
---

# tui-design-skill

> Catalogue stub — full skill: [gfargo/tui-design-skill](https://github.com/gfargo/tui-design-skill)

<!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block -->
## Decision tree

1. **Is the full skill already installed?**
   Upstream names this skill `tui-design`, so it installs next to this pointer (the pointer is not replaced).
   - Global: `f=~/.agents/skills/tui-design/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - Project: `f=.agents/skills/tui-design/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"`
   - `installed` → the skill is installed as `tui-design`, invoke it and proceed
   - `pointer` → go to step 2

2. **Detect scope, then install:**

   ```bash
   [ -e ~/.agents/skills/tui-design-skill ] && echo "global" || echo "project"
   ```

   **Global:**
   ```bash
   npx skills add gfargo/tui-design-skill --skill tui-design -g -y
   ```

   **Project:**
   ```bash
   npx skills add gfargo/tui-design-skill --skill tui-design -y
   ```
   > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation.

**Heads-up**

- **License:** MIT
<!-- das:install:end -->

## Invoke after install

- Skill name: `tui-design`
- Trigger phrases: "TUI design", "terminal UI", "Bubble Tea", "Ratatui", "Textual Python", "Ink TypeScript"

## What it does

Provides design knowledge for building professional terminal user interfaces and command-line tools across four major ecosystems: Go with Bubble Tea and Lipgloss, Rust with Ratatui, Python with Textual, and TypeScript/Node.js with Ink. A core skill file holds the workflow and cross-cutting rules (layout, color systems from true color to ANSI, keybinding conventions, focus management, discoverability) and loads one framework-specific reference when needed. Covers full-screen TUIs, interactive prompts, and plain CLIs.

## When NOT to use

- Web UI design — use a frontend-design skill instead
- Deep Textual (Python) work beyond layout conventions — use `textual-tui-skill`
- Simple CLI argument parsing without interactive UI

© podo · MIT · podo/design-agent-skills

Similar skills

All skills for Design →

From the same set108

The whole set →
claudedesignskills claudedesignskills — a collection of 22 skills covering WebGL, 3D graphics, and motion libraries from Three.js to Rive. Useful for complex creative frontend workflows. CX Codex +1 216installs design-engineering-catalogue design-engineering-catalogue — a guide to skills for visual design, mobile interfaces, typography, and components. Use it to find a tool that matches a design task. CX Codex +1 215installs accessibility-agents accessibility-agents is a Claude Code skill that routes accessibility checks to specialists and combines findings in a WCAG 2.2 AA report. CX Codex +1 215installs design-html design-html turns a design mockup into production HTML/CSS. Works from /design-shotgun output, a plan, or a freeform brief. CX Codex +1 215installs humanize-text humanize-text grades a piece of writing on seven scales from 1 to 10 and returns a rewritten version without the usual AI tells. CX Codex +1 214installs p5js-hermes p5js-hermes is a Claude Code skill for creating generative and interactive p5.js visuals with noise, particles, flow fields and shaders, and exporting sketches to PNG, GIF or MP4. CX Codex +1 214installs open-design open-design is a Claude Code skill with a local daemon, web UI, and MCP server for generating prototypes, landing pages, dashboards, and other design assets through a coding agent. CX Codex +1 214installs product-position The product-position skill shapes B2B SaaS positioning, message hierarchy, and competitive framing. Use it to start a positioning strategy or review one already in use. CX Codex +1 213installs

Project sponsors

Companies that keep this analytics open