Use this skill after functional code works, before shipping or handoff, to elevate generic or rough UI into crisp, intentional product craft.
Checklist
- Visual hierarchy & layout rhythm: · Verify one clear primary focal point per view; remove redundant borders, nested cards, or competing saturated accents. · Check optical alignment (icons paired with text labels, mono numerals with
tabular-nums, button padding balance) and consistent spacing scale steps. - Complete interactive state matrix: · Every interactive control handles default, hover, focus-visible, active/pressed, disabled, loading/pending, and error cleanly without layout shift. · Data views handle loading (skeleton/status), empty (clear next action), error (recoverable message), and populated states.
- Responsive integrity down to `360px` (and `320px` stress check): · Check long labels, monospace code blocks, URLs, and CTA buttons inside cards for horizontal overflow (
min-w-0, wrapping, horizontal scroll on wide tables/code only where intended). · Ensure touch/pointer targets are at least24x24 CSS px(aim40–44pxfor primary mobile controls). - Dark mode & surface separation: · Verify crisp border/surface contrast in both light and dark themes (no washed-out text, invisible secondary buttons, or harsh unstyled white boxes). · Check disabled button text/background contrast as well as placeholder text (
placeholder:*legible at AA contrast where informative). - Asset & SVG cleanliness: · Run custom inline SVGs or icons through
design_utils({ action: "svg_optimise" })and ensure decorative icons carryaria-hidden="true".
Done when
- Zero horizontal overflow down to
360px, complete interactive/empty/error states, balanced spacing/typography hierarchy, and clean light/dark parity.