# ui-polish

ui-polish is a Claude Code skill that finds and fixes visual flaws in Team AX. It checks the web app and desktop shell across screen sizes and color themes.

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

## What it does

The skill guides a visual pass over Team AX: inspect the screens, spot cramped spacing, alignment issues, clipped text and inconsistent buttons, then make focused fixes. The workflow starts the app with a mock server, checks its roles and screens, captures screenshots before edits and records findings. Screenshots cover different viewport sizes, themes and interface languages.

It favors shared UI components and existing color tokens, while keeping copy meaning, flows, permissions and test IDs intact. After edits, capture the affected screens again and run `bun run typecheck` and `bunx playwright test`. Changes outside `web/` also call for `bun test tests/unit`. The checks require Bun and Playwright and use a mock server rather than real data or engines.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add trina-app/trina-ax --skill ui-polish -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add trina-app/trina-ax --skill ui-polish -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add trina-app/trina-ax --skill ui-polish -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install trina-app/trina-ax .claude/skills/ui-polish
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add trina-app/trina-ax --skill ui-polish -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/trina-app/trina-ax --path .claude/skills/ui-polish
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ui-polish/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/trina-app/trina-ax/tree/HEAD/.claude/skills/ui-polish/SKILL.md

## When to use it
- find interface elements with cramped padding
- fix uneven spacing and misaligned rows
- remove clipped text and horizontal scrolling on phone screens
- check dark mode and loading states

## Example prompts
- Inspect Team AX and fix the spacing problems you find.
- Check Team AX screens at phone width in dark mode.
- Find clipped text and inconsistent buttons in the Team AX interface.

## Similar
- [impeccable-design-polish](https://affpapa.org/en/nevibecode/skills/impeccable-design-polish.md) — skill · 2800 installs
- [ce-polish](https://affpapa.org/en/nevibecode/skills/ce-polish.md) — skill · 1200 installs
- [phase-10d-chat-ui-polish-research](https://affpapa.org/en/nevibecode/prompts/phase-10d-chat-ui-polish-research.md) — prompt · ★ 1497 repo stars
- [polish](https://affpapa.org/en/nevibecode/skills/polish.md) — skill · 727 installs
- [suede-design](https://affpapa.org/en/nevibecode/skills/suede-design.md) — skill · ★ 121 repo stars
- [source-html-to-app-ui](https://affpapa.org/en/nevibecode/skills/source-html-to-app-ui.md) — skill · 233 installs

## Other versions with the same name
- [ui-polish · agentes-chat](https://affpapa.org/en/nevibecode/skills/ui-polish.md) — ★ 1914 repo stars

From the same set: [trina-app/trina-ax](https://affpapa.org/en/nevibecode/by/trina-app/trina-ax.md) — 6 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
