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
npx skills add podo/design-agent-skills --skill tui-design-skill -a claude-codeWhat 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-designto design a Go terminal UI withBubble TeaandLipgloss, including layout and keybindings. - Review this
Ratatuiinterface for color use, focus behavior, and discoverability. - Build an interactive Python CLI with
Textualand 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-code2Manually: put the files in place
~/.claude/skills/tui-design-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tui-design-skill/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill tui-design-skill -a codex2Manually: put the files in place
.agents/skills/tui-design-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill tui-design-skill -a cursor2Manually: put the files in place
.cursor/skills/tui-design-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/tui-design-skill2Manually: put the files in place
.github/skills/tui-design-skill/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill tui-design-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/tui-design-skillManually: put the files in place
.devin/skills/tui-design-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill tui-design-skill -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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