# tui-ui-guidelines

The tui-ui-guidelines skill for Claude Code provides standards for building Warp TUI interfaces. Install this before starting any TUI implementation task.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 720 repo stars
- Author: dominikmartn
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dominikmartn/harp/tree/HEAD/.agents/skills/tui-ui-guidelines/SKILL.md
- Updated: 2026-11-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/tui-ui-guidelines

## What it does

This skill details the requirements for building front-end components within the `crates/warp_tui` module. It clarifies that GUI assumptions like pixel geometry, GPU rendering, or WGSL shaders are invalid here, directing developers to use the grid-based `TuiElement` library instead.

Developers should implement the `TuiElement` trait and utilize the semantic styling helpers from `TuiUiBuilder`. Always call `.finish()` when constructing an element tree to ensure consistency. The skill provides the necessary reference for element composition and input handling within the terminal environment.

Ensure that you have access to the component directory at `crates/warpui_core/src/elements/tui` before applying these guidelines.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill tui-ui-guidelines -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/tui-ui-guidelines/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/tui-ui-guidelines/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill tui-ui-guidelines -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/tui-ui-guidelines/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill tui-ui-guidelines -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/tui-ui-guidelines/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dominikmartn/harp .agents/skills/tui-ui-guidelines
```

2. **Manually: put the files in place**
- File: `.github/skills/tui-ui-guidelines/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill tui-ui-guidelines -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/dominikmartn/harp --path .agents/skills/tui-ui-guidelines
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/tui-ui-guidelines/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/dominikmartn/harp/tree/HEAD/.agents/skills/tui-ui-guidelines/SKILL.md

## When to use it
- Design a UI component using `TuiElement`
- Apply consistent themes via `TuiUiBuilder`
- Compose layouts using `TuiFlex` containers
- Attach key handlers with `TuiEventHandler`

## Example prompts
- tui-ui-guidelines: how to style `TuiText` properly?
- tui-ui-guidelines: show a `TuiFlex` column example
- tui-ui-guidelines: what are the rules for `TuiElement`?

## Similar
- [ratatui-tui](https://affpapa.org/en/nevibecode/skills/ratatui-tui.md) — skill · 959 installs
- [tui-fundamentals](https://affpapa.org/en/nevibecode/skills/tui-fundamentals.md) — skill · 369 installs
- [create-agent-tui](https://affpapa.org/en/nevibecode/skills/create-agent-tui.md) — skill · 358 installs
- [tui-design-skill](https://affpapa.org/en/nevibecode/skills/tui-design-skill.md) — skill · 215 installs
- [tui-design](https://affpapa.org/en/nevibecode/skills/tui-design.md) — skill · 1400 installs
- [codex-debugging](https://affpapa.org/en/nevibecode/skills/codex-debugging.md) — skill · 108 installs

From the same set: [dominikmartn/harp](https://affpapa.org/en/nevibecode/by/dominikmartn/harp.md) — 62 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
