Remove unnecessary borders, backgrounds, shadows, decorations
How this skill is triggered — by the user, by Claude, or both
Slash command
/refactoring-ui-skills:06-eliminate-visual-clutterThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Remove unnecessary visual elements (borders, backgrounds, shadows, decorations) that don't serve functional purposes.
Remove unnecessary visual elements (borders, backgrounds, shadows, decorations) that don't serve functional purposes.
Corrective + Evaluative
Identifies and removes decorative elements that don't communicate meaning, using whitespace and contrast instead.
| Element | Ask | Often Remove? |
|---|---|---|
| Borders | Does this need a border, or just space? | Yes, use margin instead |
| Card backgrounds | Does this need a box, or just whitespace? | Often, let space define groups |
| Separators | Does this need a line, or just more space? | Usually, increase gap instead |
| Shadows | Does this need depth, or is it decorative? | Often, flatten |
| Background colors | Is this color communicating something? | If purely decorative, remove |
| Icons | Does this icon add meaning? | If decorative only, remove |
| Failure | Description | Fix |
|---|---|---|
| Border-itis | Every element has a box around it | Remove 50%+ of borders, use space |
| Shadow Spam | Shadows on static elements | Reserve for hover states and modals |
| Separator Overload | Lines between every section | Remove half, double the space |
| Background Soup | Every card has a gray background | Use white with space, or subtle border |
| Icon Explosion | Icons on every label and button | Keep only when they add meaning |
| Gradient Gone Wild | Decorative gradients everywhere | Flatten or use one purposeful gradient |
apply-consistent-spacing (whitespace replaces borders)establish-visual-hierarchy (contrast replaces decoration)Input: Card with: border (1px gray), background (#f5f5f5), shadow (sm), title with icon, separator line, content, separator line, footer with icon and text
Evaluation: FAIL (cluttered)
Recommendation:
npx claudepluginhub gnurio/refactoring-ui-plugin --plugin refactoring-ui-skillsAdd depth only when functionally necessary (elevation, not decoration)
Reduces visual intensity in bold or overstimulating designs by desaturating colors, softening contrasts, and simplifying visual hierarchy for a refined, calmer aesthetic.
Applies the design principle of removing rather than adding — finding the form that does exactly what is needed, nothing more.