refactoring-ui

Installation
SKILL.md

Refactoring UI Design System

Core Philosophy

Design decisions should be made with intention, not decoration. Every visual choice—color, size, spacing, weight—communicates hierarchy and guides the user's attention. Start with too much whitespace, then remove it. Start with less contrast, then add it where needed.

Before writing any CSS, answer: what should this feel like? A financial dashboard and a children's learning app demand completely different visual treatments. The sections below move from strategic thinking (personality, color theory, layout strategy) down to tactical execution (spacing values, shadow syntax, animation timing).


Design Thinking

Design Personality & Tone

Every interface has a personality whether you choose one or not. Choosing intentionally is the difference between a design that feels right and one that feels generic.

The Personality Spectrum

Plot your design on two axes:

Installs
20
GitHub Stars
24
First Seen
Mar 31, 2026
refactoring-ui — jaywilburn/refactoring-ui-skill