refactoring-ui

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

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/trobias/portfolio-nextjs-v2 --skill refactoring-ui-trobias
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refactoring-ui
Source: https://github.com/trobias/portfolio-nextjs-v2/tree/main/.agents/skills/refactoring-ui
Command: npx skills add https://github.com/trobias/portfolio-nextjs-v2 --skill refactoring-ui-trobias

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Web interfaces often look amateur because of arbitrary spacing values, weak visual hierarchy, clashing colors, and missing depth cues. This Skill provides a systematic, constraint-based design framework that diagnoses these issues and prescribes concrete fixes using fixed scales for spacing, typography, color, and shadows. ## Core Features & Use Cases - Quick Diagnostic Scoring: Audit any UI against 8 yes/no checks (blur test, grayscale test, spacing scale, contrast) and compute a 0-10 score with specific rows to fix. - Constrained Design Scales: Apply fixed spacing (4/8/16/24/32/48/64px), modular type scale, 5-9 shade color palettes, and a shadow elevation scale instead of arbitrary values. - Deep Reference Guides: Load on-demand references for dark mode theming, WCAG 2.1 AA accessibility, animation timing and easing, data visualization, and advanced component patterns like modals, forms, and navigation. - Use Case: A developer says their dashboard "looks off." The Skill runs the diagnostic, finds labels competing with data and arbitrary padding values, then prescribes de-emphasized labels, a 4/8/16/24 spacing scale, and gray-700 text for contrast compliance. ## 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 the blur test, verify it works in grayscale, increase white space, de-emphasize labels, and replace arbitrary pixel values with the 4/8/16/24/32/48/64 spacing scale. Most amateur-looking UIs fail on insufficient white space and unconstrained content widths.

What spacing scale should I use in Tailwind CSS?▼

Use the constrained scale of 4, 8, 16, 24, 32, 48, and 64 pixels, which maps to Tailwind classes p-1 through p-16. Keep spacing between groups larger than spacing within groups, and start with too much white space before removing any.

How do I design a dark mode theme correctly?▼

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

What contrast ratio does WCAG 2.1 AA require for text?▼

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 requirement.

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.

Why does pure black look bad in dark mode interfaces?▼

Pure black (#000000) creates harsh contrast and halation, where light text appears to glow against the background. Dark grays like #09090b to #18181b produce comfortable contrast while preserving surface hierarchy through lightness steps.