# ui-polish

ui-polish — a Claude Code skill with measured interface rules and a review routine. It runs before UI changes and during design reviews.

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

## What it does

This skill sets numbered interface rules for agentes.chat and lays out a check routine for changes. It covers `apps/web`, `packages/ui`, `apps/mobile`, and `apps/desktop`, with defined control sizes and spacing. The rules call for design tokens instead of raw pixel values and keep the project's fonts in place.

The routine checks the shared UI component and its siblings, captures before-and-after screens at widths 1280 and 390, then runs `break-ui` and an Impeccable audit. The CI geometry check stays green. Rules cover layout, alignment, and text, including a separate narrow-screen treatment for task lists.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add agentes-chat/agentes-chat --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 agentes-chat/agentes-chat --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 agentes-chat/agentes-chat --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 agentes-chat/agentes-chat .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 agentes-chat/agentes-chat --skill ui-polish -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/agentes-chat/agentes-chat --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/agentes-chat/agentes-chat/tree/HEAD/.claude/skills/ui-polish/SKILL.md

## When to use it
- keep control sizes and spacing consistent
- catch alignment problems after UI edits
- compare screens before and after a change
- preserve component geometry across screen sizes

## Example prompts
- Update the profile page spacing in `apps/web` using the project rules.
- Review the dialog layout and check it at a narrow screen width.
- Change the card in `packages/ui` and check its sibling components.

## Similar
- [polish](https://affpapa.org/en/nevibecode/skills/polish.md) — skill · 727 installs
- [designing-beautiful-websites](https://affpapa.org/en/nevibecode/skills/designing-beautiful-websites.md) — skill · 2800 installs
- [frontend-design](https://affpapa.org/en/nevibecode/skills/practicalswan-frontend-design.md) — skill · 241 installs
- [phase-10d-chat-ui-polish-research](https://affpapa.org/en/nevibecode/prompts/phase-10d-chat-ui-polish-research.md) — prompt · ★ 1497 repo stars
- [ui-design](https://affpapa.org/en/nevibecode/skills/mindrally-ui-design.md) — skill · 1000 installs
- [21st-ui-review](https://affpapa.org/en/nevibecode/skills/21st-ui-review.md) — skill · 1900 installs

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

---
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
