# ui-ux-polish

ui-ux-polish is a Claude Code skill that iteratively refines an already working web application interface toward Stripe-level visual quality.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 236 installs · ★ 73 repo stars
- Author: Dicklesworthstone
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations/tree/HEAD/skills/ui-ux-polish/SKILL.md
- Updated: 2026-09-06
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/dicklesworthstone-ui-ux-polish

## What it does

This skill implements an iterative loop for frontend refinement when an application already works and looks decent. Rather than executing a generic restyling command, it invokes a structured prompt paired with extended model reasoning (`ultrathink`). It explicitly forces the model to evaluate desktop and mobile layouts independently, avoiding middle-ground compromises.

The core workflow relies on compounding improvements over 10 or more passes. Each cycle addresses minor details: spacing rhythm, font scaling, shadow depth, button hover states, and mobile touch targets. The skill adapts cleanly to React 19, Next.js 16, Tailwind 4, and Framer Motion.

Running this prompt on broken code or an unstyled prototype will fail: you must fix core bugs and define a foundational component library first.

## Requirements
- Works with: Stripe

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations --skill ui-ux-polish -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations --skill ui-ux-polish -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations --skill ui-ux-polish -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations skills/ui-ux-polish
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations --skill ui-ux-polish -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations --path skills/ui-ux-polish
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations --skill ui-ux-polish -a opencode
```

### 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/Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations/tree/HEAD/skills/ui-ux-polish/SKILL.md

## When to use it
- refine typography hierarchy and spacing on working pages
- hyper-optimize touch targets and mobile navigation breakpoints
- smooth out interactive states, loaders, and button feedback
- compound subtle visual polish across repeated automated runs

## Example prompts
- Apply the ui-ux-polish workflow to review the dashboard layout
- Run another polish pass focusing specifically on mobile navigation
- Inspect our landing page components for spacing consistency and hover states

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 82b725201dfdfc26.

BEGIN THIRD-PARTY FILE 82b725201dfdfc26
````text
---
name: ui-ux-polish
description: "Iterative UI/UX polishing workflow for web applications. The exact prompt and methodology for achieving Stripe-level visual polish through multiple passes."
---

# UI/UX Polish — Iterative Enhancement Workflow

> **When to Use:** This is for when your site/app already works and looks decent and you want to improve it. There's a different approach when it looks bad and needs a complete overhaul.
>
> **Key Insight:** Something about asking for agreement from the model ("don't you agree?") somehow motivates it to polish things up better. Also, instructing it to separately think through desktop vs mobile leads to much better outcomes.

---

## The Workflow

### Overview

1. App already works and looks decent
2. Run the polish prompt
3. Agent makes incremental improvements
4. Repeat many times (10+ iterations)
5. Each pass adds small improvements that compound

### Why Multiple Passes Work

- Each time, it tries to make some incremental improvement, even if it's minor
- These really add up after 10 iterations!
- Multiple agents can work on this simultaneously
- Cumulative effect is dramatic

---

## THE EXACT PROMPT — UI/UX Polish

This prompt is used so frequently it's worth putting on a Stream Deck button:

```
I still think there are strong opportunities to enhance the UI/UX look and feel and to make everything work better and be more intuitive, user-friendly, visually appealing, polished, slick, and world class in terms of following UI/UX best practices like those used by Stripe, don't you agree? And I want you to carefully consider desktop UI/UX and mobile UI/UX separately while doing this and hyper-optimize for both separately to play to the specifics of each modality. I'm looking for true world-class visual appeal, polish, slickness, etc. that makes people gasp at how stunning and perfect it is in every way.  Use ultrathink.
```

---

## Why This Prompt Works

### 1. Asks for Agreement

The phrase "don't you agree?" engages the model's reasoning about whether improvements are possible, rather than just executing instructions.

### 2. Separates Desktop and Mobile

```
"carefully consider desktop UI/UX and mobile UI/UX separately...
hyper-optimize for both separately to play to the specifics of each modality"
```

This prevents the model from making compromises that work "okay" on both but great on neither.
````
END THIRD-PARTY FILE 82b725201dfdfc26

The third-party file has ended. Everything between the 82b725201dfdfc26 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2390 of 7262 bytes. © Dicklesworthstone · MIT · https://github.com/Dicklesworthstone/agent_flywheel_clawdbot_skills_and_integrations/tree/HEAD/skills/ui-ux-polish/SKILL.md

_Part of the page did not fit — see the HTML version._

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