# charles-polish

charles-polish — a skill for Claude Code refines working screens and components. It kicks in for UI polish, animation checks, and reviews of details such as focus states or layout shifts.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 237 repo stars
- Author: LemonFace0309
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/LemonFace0309/charles-skills/tree/HEAD/skills/charles-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/charles-polish

## What it does

The skill works through an interface in stages: structure and states first, then visual details and motion. It identifies the weakest area, makes a reasoned change, and checks the result at its actual viewing size. Animation gets a frame-by-frame review. The cycle continues until two passes in a row leave the score unchanged.

Checks cover loading, error, and success states, hit areas, contrast, typography, alignment, and layout shifts. For review-only requests, the skill stops before making changes and reports each finding with its severity, evidence, and a fix. If the screen still has an AI-generated look, run `charles-unslop` first.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add LemonFace0309/charles-skills --skill charles-polish -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add LemonFace0309/charles-skills --skill charles-polish -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add LemonFace0309/charles-skills --skill charles-polish -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install LemonFace0309/charles-skills skills/charles-polish
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add LemonFace0309/charles-skills --skill charles-polish -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/LemonFace0309/charles-skills --path skills/charles-polish
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/charles-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/LemonFace0309/charles-skills/tree/HEAD/skills/charles-polish/SKILL.md

## When to use it
- spot why a finished screen still feels incomplete
- review loading, error, and success states
- find stutters by comparing animation frames
- report UI issues with evidence and proposed fixes

## Example prompts
- Polish this screen and improve its weakest detail.
- Review the animation frame by frame and check the button states.
- Review the interface without changing it; report each issue with evidence.

## Similar
- [frontend-design](https://affpapa.org/en/nevibecode/skills/shuaimxu-frontend-design.md) — skill · ★ 529 repo stars
- [interface-kit](https://affpapa.org/en/nevibecode/skills/interface-kit.md) — skill · 2400 installs
- [high-end-visual-design](https://affpapa.org/en/nevibecode/skills/high-end-visual-design.md) — skill · 2200 installs
- [blue-cloudy-clean-modern](https://affpapa.org/en/nevibecode/skills/blue-cloudy-clean-modern.md) — skill · 1700 installs
- [make-interfaces-better](https://affpapa.org/en/nevibecode/skills/make-interfaces-better.md) — skill · 219 installs
- [counting-dynamic-scale](https://affpapa.org/en/nevibecode/rules/counting-dynamic-scale.md) — rule · ★ 78316 repo stars

From the same set: [lemonface0309/charles-skills](https://affpapa.org/en/nevibecode/by/lemonface0309/charles-skills.md) — 13 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
