Better UI is an agent skill that holds the visual polish for surfaces and icons, with the exact value each detail takes. It applies after the underlying interaction is sound, and a polish finding never outranks a broken interaction.
It keeps the project’s component library, tokens and density, treating a consistent house style such as no shadows as a preference. The same detail done two ways inside one project is a finding.
What You Get
- Concentric radius rules and optical alignment nudges such as 2px less padding on the icon side of a button
- Shadow recipes that replace depth-only borders, with a transparent border kept under a shadow ring for forced-colors mode
- Image outline values in oklch black and white, with a note on why palette near-blacks leave a colored fringe
- Icon rules: currentColor SVGs, stroke from 1.5px at weight 400 to 2.5px at weight 700, outline default and fill for active, and RTL mirroring only where meaning follows direction
- A detection table covering matching radii on padded parents, hex fills in icons and unguarded hover styles
Common Use Cases
- Fixing nested cards whose inner and outer corners look mismatched
- Replacing a bordered card style with layered shadows while keeping forced-colors edges
- Stopping hover styles from sticking after a tap on touch devices
- Matching icon stroke to the text beside it across a toolbar
What Makes It Unique
Its values are exact, not ranges to approximate: an outline at 0.1 alpha is not one at 0.15, and a 1.5px stroke is not 2px. Only the optical nudges and the concentric padding cutoff are judged by eye. It also gives every adjacent topic, from hit areas to transitions, to a named sibling skill.
Under The Hood
The skill is a SKILL.md with three reference files for icons, surfaces and reporting. It has no scripts. The agent reads your components and styles, checks each defined state such as hover, pressed, selected, loading and empty from code, and with a browser walks each state in both themes. A review leaves files untouched, and edits happen when you ask for fixes.