refactoring-ui-design

Applies Refactoring UI principles to improve interface hierarchy, spacing, color, and typography.

Updated Jun 30, 2026
One-click install
npx skills add https://github.com/kaitoartz/dotfiles --skill refactoring-ui-design-kaitoartz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refactoring-ui-design
Source: https://github.com/kaitoartz/dotfiles/tree/main/dot_gemini/config/skills/refactoring-ui-design
Command: npx skills add https://github.com/kaitoartz/dotfiles --skill refactoring-ui-design-kaitoartz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interfaces often look cluttered, flat, or confusing because developers lack a systematic design method. This Skill provides concrete, tactic-driven UI design guidance based on the Refactoring UI book, turning vague visual problems into specific fixes. ## Core Features & Use Cases - Visual Hierarchy Guidance: Establishes clear hierarchy using weight, color, and contrast instead of size alone, and de-emphasizes secondary content correctly. - Layout & Spacing Systems: Applies consistent geometric spacing scales (4-128px) and type scales (12-72px) instead of arbitrary values. - Color, Typography & Depth Tactics: Covers grayscale-first design, saturated grays, line-height rules, and shadow-based elevation. - Use Case: A developer's dashboard feels cluttered and users miss the primary action. The Skill walks through a refactor: increase whitespace, boost primary button contrast, fade secondary actions, and replace borders with background differences. ## Quick Start Review my settings page UI and suggest improvements based on Refactoring UI principles.

Frequently Asked Questions about refactoring-ui-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I improve visual hierarchy in my UI design?▼

Improve visual hierarchy by using font weight, color, and contrast rather than size alone. De-emphasize secondary text with lighter gray colors instead of smaller sizes, and make primary actions bold and high-contrast while keeping secondary actions subtle.

What spacing scale should I use for UI layouts?▼

Use a geometric spacing scale such as 4, 8, 12, 16, 24, 32, 48, 64, 96, and 128 pixels instead of arbitrary values. Apply the scale to component padding and margins, and start with more white space than you think you need.

How to fix a UI design that looks cluttered?▼

Fix cluttered designs by increasing white space and removing unnecessary borders, replacing them with background color differences or spacing alone. Follow the principle of taking elements out when in doubt, and simplify metadata and decorative backgrounds.

Should I design in grayscale before adding color?▼

Yes, designing in grayscale first forces you to solve spacing and contrast problems before relying on color. If a layout does not work in black and white, adding color will not fix the underlying hierarchy issues.

What are the limitations of principle-based UI design guidance?▼

Principle-based guidance provides heuristics rather than pixel-perfect specifications, so results still require judgment and iteration. It does not replace user testing, brand guidelines, or accessibility audits for production interfaces.