refactoring-ui

Audit web UI designs using grayscale-first hierarchy, fixed spacing scales, typography discipline, and elevation cues.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/sachio222/based-stack --skill refactoring-ui-sachio222
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactoring-ui
Source: https://github.com/sachio222/based-stack/tree/main/refactoring-ui
Command: npx skills add https://github.com/sachio222/based-stack --skill refactoring-ui-sachio222

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The core challenge of many interfaces is unclear visual hierarchy, inconsistent spacing, typography, color, and depth that degrade usability. This skill provides a disciplined framework to audit and fix these aspects.

Core Features & Use Cases

  • Grayscale-first hierarchy: Prioritize visual importance using size, weight, and color with grayscale-first thinking.
  • Constrained spacing & typography: Apply fixed spacing scales and modular typography to ensure consistency across components and layouts.
  • Depth, shadows, and color system: Establish elevation cues and a systematic color palette to communicate hierarchy and state.
  • Practical patterns & references: Leverage documented patterns and reference files to guide real-world UI improvements.

Use cases include reviewing frontend designs, auditing design tokens, and advising on visual improvements for dashboards, landing pages, and apps.

Quick Start

Audit a UI by applying grayscale-first hierarchy, spacing and typography adjustments, and elevation rules to the current design.

Frequently Asked Questions about refactoring-ui

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

FAQPage Schema
How do I fix inconsistent spacing and typography in my web UI design?

Fix inconsistent spacing and typography by applying fixed spacing scales and modular typographic discipline. This enforces consistent component layouts and visual hierarchy across dashboards, marketing sites, and product apps.

What is grayscale-first hierarchy and when should I use it for UI refinements?

Grayscale-first hierarchy prioritizes visual importance using size, weight, and color without chromatic distractions. Use it during frontend reviews and design-token audits to establish clear visual structure before applying a systematic color palette.

How do I audit design tokens for visual hierarchy and elevation cues?

Audit design tokens by evaluating grayscale-first hierarchy, constrained spacing scales, typographic discipline, and elevation rules. This process refines depth, shadows, and color systems to communicate clear hierarchy and state across interfaces.

Can I use a layered color palette and spacing scale for dashboard interfaces?

Yes, you can apply a layered color palette and fixed spacing scale to dashboard interfaces. This enforces concrete design-system principles that ensure accessible, consistent components and clear visual hierarchy across product apps.

What's the best way to establish depth and shadow rules for a design system?

Establish depth and shadow rules by applying systematic elevation cues documented in reference patterns. This communicates interface hierarchy and state consistently across web UI components, dashboards, and landing pages.

Why does my interface lack clear visual hierarchy despite using a color palette?

Your interface lacks clear visual hierarchy because color alone cannot establish structure. Applying grayscale-first thinking, constrained spacing scales, and modular typography ensures size, weight, and elevation cues communicate importance effectively.