refactoring-ui

Audit web UI hierarchy, spacing, typography, and color systems.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill solves the common developer pain point of creating amateur-looking interfaces by providing a constrained, system-based approach to design that replaces the need for artistic talent.

Core Features & Use Cases

  • Visual Hierarchy Audit: Fixes competing elements by applying strict size, weight, and color rules.
  • Design System Implementation: Provides scales for spacing, typography, and shadows to ensure consistency.
  • Use Case: When a dashboard or web application feels cluttered or unprofessional, use this Skill to audit the UI against a grayscale-first framework, ensuring proper spacing and contrast before applying color.

Quick Start

Apply the refactoring-ui framework to audit the current component by checking the visual hierarchy and spacing against the provided diagnostic scale.

Frequently Asked Questions about refactoring-ui

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

FAQPage Schema
How do I fix visual hierarchy and cluttered spacing in a web UI?

To fix visual hierarchy in a web UI, you can apply a grayscale-first design methodology to audit competing elements using strict size, weight, and color rules. This enforces consistent spacing and contrast before applying color.

What is a grayscale-first approach for component styling and design systems?

A grayscale-first approach for component styling means establishing proper visual hierarchy, typography, and spacing using constrained design tokens before introducing color. It ensures professional interface polish and prevents amateur-looking visual inconsistencies.

How do I audit frontend typography and color systems for WCAG 2.1 AA accessibility?

You audit frontend typography and color systems for WCAG 2.1 AA accessibility by evaluating visual contrast and hierarchy against a diagnostic scale. This ensures your UI meets professional compliance standards for accessible component styling.

Does this UI design approach work with Tailwind for design system creation?

Yes, this UI design methodology applies to frontend development tasks involving Tailwind. It provides constrained scales for typography, spacing, and shadows to ensure consistent design tokens and professional-grade interface polish.

How do I build consistent design tokens for spacing and typography scales?

You build consistent design tokens by implementing systematic scales for spacing, typography, and shadows. This replaces the need for artistic talent with a constrained, system-based approach to ensure interface consistency.

When should I use a system-based UI audit instead of manual styling adjustments?

You should use a system-based UI audit when a dashboard or web application feels cluttered or unprofessional. It diagnoses competing visual elements against a strict hierarchy framework, replacing manual styling adjustments with consistent design rules.