refactoring-ui

Audit and fix visual hierarchy, spacing, color, and depth in web UI designs.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/HafidJoss/Lummy --skill refactoring-ui-hafidjoss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactoring-ui
Source: https://github.com/HafidJoss/Lummy/tree/main/agent/skills/refactoring-ui
Command: npx skills add https://github.com/HafidJoss/Lummy --skill refactoring-ui-hafidjoss

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Web interfaces often look amateur or unprofessional due to arbitrary spacing, weak visual hierarchy, clashing colors, and missing depth cues, and developers lack a systematic way to diagnose and fix these issues. ## Core Features & Use Cases - UI Design Audit: Score any interface against an 8-point diagnostic covering hierarchy, grayscale readability, white space, spacing scale, text width, contrast, and shadow elevation. - Constrained Design Systems: Apply fixed scales for spacing (4-64px), typography (12-36px), color shades (50-900), and shadows to produce consistent, professional results. - Deep Reference Guides: Load on-demand references for dark mode theming, WCAG 2.1 AA accessibility, animation timing, data visualization, and advanced component patterns. - Use Case: When a user says "my dashboard looks off," audit it with the quick diagnostic, identify failing rows (e.g., arbitrary spacing, labels competing with data), and apply the corresponding fixes with Tailwind CSS classes. ## Quick Start Audit my dashboard UI using the refactoring-ui diagnostic and tell me the score plus the specific fixes needed to reach 10 out of 10.

Frequently Asked Questions about refactoring-ui

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

FAQPage Schema
How do I fix a UI that looks amateur or unprofessional?

Run the 8-point quick diagnostic: check hierarchy with a blur test, verify it works in grayscale, increase white space, de-emphasize labels, and enforce the 4/8/16/24/32/48/64px spacing scale. Most amateur-looking UIs fail on insufficient white space and unconstrained content widths.

How to build a dark mode theme with Tailwind CSS?

Use dark grays like #18181b instead of pure black, off-white #fafafa instead of pure white text, and desaturated accent colors. Convey elevation with lighter surfaces rather than shadows, and switch themes via CSS custom properties or Tailwind's class-based dark mode.

What color contrast ratio is required for WCAG AA compliance?

WCAG 2.1 AA requires 4.5:1 for normal text under 18px, 3:1 for large text, and 3:1 for UI components. On white backgrounds, use gray-700 (#374151) or darker for body text since lighter grays like gray-400 fail the threshold.

Why does my UI feel flat and lack depth?

Flat UIs usually lack an elevation system. Apply a shadow scale where small shadows indicate slightly raised elements like buttons and large shadows indicate floating elements like modals, or use lighter top borders and subtle gradients as shadow alternatives.

When should I not use a pie chart for data visualization?

Avoid pie charts when comparing values, showing more than 5 categories, displaying change over time, or when values do not sum to 100%. Use bar charts for comparisons and line charts for trends instead.