refactoring

Audit and refactor UI design with grayscale-first hierarchy, spacing scales, and consistent tokens.

2|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/fernando-bertholdo/4-successful-AI-life --skill refactoring-fernando-bertholdo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactoring
Source: https://github.com/fernando-bertholdo/4-successful-AI-life/tree/main/plugins/ui-excellence/skills/systems/refactoring
Command: npx skills add https://github.com/fernando-bertholdo/4-successful-AI-life --skill refactoring-fernando-bertholdo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

UI design often suffers from inconsistent hierarchy, spacing, color, and depth across components, leading to confusion and reduced perceived quality.

Core Features & Use Cases

  • Establish grayscale-first design foundations and constrained spacing scales to improve readability and coherence across screens.
  • Create and apply token systems for typography, color, borders, and shadows to ensure consistency in frontend code and visual language.
  • Real-world scenario: refactor a dashboard or form-heavy interface to achieve uniform typography, spacing, and color semantics, enhancing usability and polish.

Quick Start

Run a quick UI refactor pass on the current screen to apply grayscale-first hierarchy, spacing, and a standardized token set.

Frequently Asked Questions about refactoring

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

FAQPage Schema
How do I enforce consistent spacing and typography in a web application design system?

To enforce consistent spacing and typography in a web design system, audit your components and apply constrained spacing scales, grayscale-first hierarchy, and standardized design tokens for color, borders, and shadows.

What is grayscale-first hierarchy in UI design and when should I use it?

Grayscale-first hierarchy in UI design establishes visual structure using neutral tones before applying color, ensuring readability and coherence. Use it when auditing and refactoring screens to improve perceived quality and usability.

How do I refactor a dashboard UI to fix inconsistent visual hierarchy and depth?

To refactor a dashboard UI and fix inconsistent visual hierarchy, run an audit pass to enforce grayscale-first structure, apply a constrained spacing scale, and standardize token systems for typography, color, borders, and shadows.

Can I use this approach to review frontend code for design token consistency?

Yes, you can use this approach to review frontend code by checking for the application of standardized token systems for typography, color, borders, and shadows to ensure consistent visual language across components.

What's the best way to build a scalable design system for form-heavy interfaces?

The best way to build a scalable design system for form-heavy interfaces is to establish constrained spacing scales and apply consistent token systems across components, achieving uniform typography and enhanced usability.

Why does my UI design look unpolished despite having individual components built correctly?

Your UI design may look unpolished due to inconsistent hierarchy, spacing, color, and depth across components. Refactoring the interface with standardized tokens and grayscale-first hierarchy ensures coherence and improves perceived quality.