Back to search
ui-polish
SkillWorks with Claude CodeGitHub
Claude Code skill: research-backed UI motion & polish that fits the product's vibe
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/viviannnl--ui-polish)HTML
<a href="/listings/viviannnl--ui-polish"><img src="/api/listings/viviannnl--ui-polish/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Symlink the skill folder into your Claude Code skills directory:
ln -s "$PWD/skills/ui-polish" ~/.claude/skills/ui-polish
Then ask Claude to "polish the UI", "add transitions", "make things appear one by one on load", and so on.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 53 lines
- # ui-polish
- A Claude Code skill for adding transitions, micro-interactions, entrance
- choreography and loading states to an existing web UI, derived from the
- product's own visual vibe so the polish feels like it belongs there.
- It's built on research from Emil Kowalski, Rauno Freiberg, Vercel's Web Interface
- Guidelines, Apple HIG, Material 3, IBM Carbon, NN/g, web.dev, MDN and Josh Comeau
- (see `skills/ui-polish/references/sources.md`). It also carries field notes from a
- shipped project, the Algorithm Visualizer's "creamy CRT" motion pass.
- ## What it does
- 1. Reads the UI's look (radii, depth, type, texture, density) and writes a
- **motion personality**: metaphor, speed, easing, signature moments, things to never do.
- 2. Ranks every moment by how often users see it. Frequent actions stay instant;
- rare ones may carry character.
- 3. Adds motion in four layers: micro-interactions → state transitions →
- entrance choreography → loading/buffering.
- 4. Verifies in a real browser with a slow-motion filmstrip, reduced-motion checks,
- settled-state and no-replay tests.
- ## Layout
- ```
- skills/ui-polish/
- ├── SKILL.md workflow + ship gate
- ├── assets/motion.css tokens, entrance classes, reduced-motion block
- └── references/
- ├── vibe-mapping.md look → motion personality
- ├── micro-interactions.md hover, press, focus, popovers, toasts, drags
- ├── transitions.md easing, FLIP, View Transitions, choreography
- ├── loading.md thresholds, skeletons, optimistic UI
- ├── verify.md filmstrip, settle helper, Playwright assertions
- ├── field-notes.md real bugs and their fixes
- └── sources.md citations and where sources disagree
- ```
- ## Install
- Symlink the skill folder into your Claude Code skills directory:
- ```bash
- ln -s "$PWD/skills/ui-polish" ~/.claude/skills/ui-polish
- ```
- Then ask Claude to "polish the UI", "add transitions", "make things appear one by
- one on load", and so on.
- ## Companion skills
- - `vibe-ui` builds the interface; run it first on new UI.
- - `ui-testing` covers the broader test suite; this skill's `verify.md` adds the motion-specific checks.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.