refactoring-ui

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

Updated Jun 27, 2026
One-click install
npx skills add https://github.com/rachmadideni/ai-staff-assistant --skill refactoring-ui-rachmadideni
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refactoring-ui
Source: https://github.com/rachmadideni/ai-staff-assistant/tree/main/.agents/skills/refactoring-ui
Command: npx skills add https://github.com/rachmadideni/ai-staff-assistant --skill refactoring-ui-rachmadideni

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Web interfaces often look amateur due to arbitrary spacing, weak visual hierarchy, clashing colors, and flat layouts. This Skill provides a systematic, constraint-based design framework so developers can diagnose and fix UI design problems without needing a professional designer. ## Core Features & Use Cases - Seven-Principle Design Framework: Covers visual hierarchy, spacing scales, typography, color systems, shadows and depth, images and icons, and layout composition with concrete CSS and Tailwind patterns. - Scored UI Audits: Rates any UI design 0-10 against the framework and lists the specific improvements needed to reach 10/10, with a quick diagnostic checklist for common issues. - Deep Reference Guides: On-demand references for accessibility (WCAG 2.1 AA), dark mode theming, animation and microinteractions, data visualization, and advanced component patterns like modals, dropdowns, and navigation. - Use Case: A developer says "my dashboard looks unprofessional." The Skill audits it against the framework, identifies insufficient white space and competing hierarchy, and prescribes fixes: constrain content width, apply the 4/8/16/24/32 spacing scale, and de-emphasize labels relative to values. ## Quick Start Review my dashboard UI and score it against the Refactoring UI principles, then tell me exactly what to change to reach 10/10.

Frequently Asked Questions about refactoring-ui

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

FAQPage Schema
How do I make my UI look more professional without a designer?▼

Apply constrained design systems instead of arbitrary values: use a fixed spacing scale (4, 8, 16, 24, 32, 48, 64px), a modular type scale, and a 5-9 shade color palette. Design in grayscale first to force hierarchy through size, weight, and spacing before adding color.

How to fix visual hierarchy in a web interface?▼

Create hierarchy through three levers: size, weight, and color, but combine rather than multiply them. De-emphasize secondary content like labels and metadata so primary content stands out, and reserve the strongest treatment for the single most important element.

What color contrast ratio is required for WCAG accessibility?▼

WCAG 2.1 AA requires 4.5:1 contrast 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 rather than lighter grays.

How do I implement dark mode without just inverting colors?▼

Use dark grays like #18181b instead of pure black, off-white text instead of pure white, and desaturated accent colors. Show elevation with lighter surfaces rather than shadows, which are invisible on dark backgrounds.

Why does my UI feel cluttered even with few elements?▼

Clutter usually comes from equal spacing everywhere and insufficient white space. Group related items with tight spacing, separate groups with larger gaps, and start with more white space than feels necessary before removing any.

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

Avoid pie charts when comparing values, showing more than five categories, or displaying change over time. Use bar charts for comparisons and line charts for trends; for two values, a simple percentage statement is often clearer.