Skip to content
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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/viviannnl--ui-polish/badge.svg)](/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
  1. # ui-polish
  2. A Claude Code skill for adding transitions, micro-interactions, entrance
  3. choreography and loading states to an existing web UI, derived from the
  4. product's own visual vibe so the polish feels like it belongs there.
  5. It's built on research from Emil Kowalski, Rauno Freiberg, Vercel's Web Interface
  6. Guidelines, Apple HIG, Material 3, IBM Carbon, NN/g, web.dev, MDN and Josh Comeau
  7. (see `skills/ui-polish/references/sources.md`). It also carries field notes from a
  8. shipped project, the Algorithm Visualizer's "creamy CRT" motion pass.
  9. ## What it does
  10. 1. Reads the UI's look (radii, depth, type, texture, density) and writes a
  11. **motion personality**: metaphor, speed, easing, signature moments, things to never do.
  12. 2. Ranks every moment by how often users see it. Frequent actions stay instant;
  13. rare ones may carry character.
  14. 3. Adds motion in four layers: micro-interactions → state transitions →
  15. entrance choreography → loading/buffering.
  16. 4. Verifies in a real browser with a slow-motion filmstrip, reduced-motion checks,
  17. settled-state and no-replay tests.
  18. ## Layout
  19. ```
  20. skills/ui-polish/
  21. ├── SKILL.md workflow + ship gate
  22. ├── assets/motion.css tokens, entrance classes, reduced-motion block
  23. └── references/
  24. ├── vibe-mapping.md look → motion personality
  25. ├── micro-interactions.md hover, press, focus, popovers, toasts, drags
  26. ├── transitions.md easing, FLIP, View Transitions, choreography
  27. ├── loading.md thresholds, skeletons, optimistic UI
  28. ├── verify.md filmstrip, settle helper, Playwright assertions
  29. ├── field-notes.md real bugs and their fixes
  30. └── sources.md citations and where sources disagree
  31. ```
  32. ## Install
  33. Symlink the skill folder into your Claude Code skills directory:
  34. ```bash
  35. ln -s "$PWD/skills/ui-polish" ~/.claude/skills/ui-polish
  36. ```
  37. Then ask Claude to "polish the UI", "add transitions", "make things appear one by
  38. one on load", and so on.
  39. ## Companion skills
  40. - `vibe-ui` builds the interface; run it first on new UI.
  41. - `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 in

Free to use. If it’s helped, pass it on.