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.