refactoring-ui

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

Updated Jun 24, 2026
One-click install
npx skills add https://github.com/tayiorbeii/paperclip-factory-kit-hermes --skill refactoring-ui-tayiorbeii
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refactoring-ui
Source: https://github.com/tayiorbeii/paperclip-factory-kit-hermes/tree/main/skills/paperclip/refactoring-ui
Command: npx skills add https://github.com/tayiorbeii/paperclip-factory-kit-hermes --skill refactoring-ui-tayiorbeii

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Web interfaces often look unpolished because of arbitrary spacing values, weak visual hierarchy, clashing colors, and missing depth cues. This Skill provides a systematic, seven-principle framework for auditing and fixing UI design without requiring a professional designer. ## Core Features & Use Cases - Design Audits with Scoring: Rate any UI 0-10 against principles covering hierarchy, spacing, typography, color, shadows, images, and layout, with specific fixes to reach 10/10. - Constrained Design Systems: Apply fixed scales for spacing (4-64px), modular type scales, 5-9 shade color palettes, and elevation-based shadow levels instead of arbitrary values. - Grayscale-First Workflow: Build hierarchy through size, weight, and spacing before adding color, ensuring designs work without relying on color as a crutch. - Use Case: A developer ships a dashboard that "feels off" — use this Skill to diagnose that labels compete with data values, spacing is inconsistent, and text lacks contrast, then apply concrete Tailwind-style fixes. ## Quick Start Review my dashboard UI and score it against the Refactoring UI principles, then list the specific fixes needed to reach 10/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?▼

Start by adding more white space and constraining content widths, since most amateur designs are too dense. Then establish visual hierarchy by varying size, weight, and color between primary and secondary elements, and replace arbitrary pixel values with a fixed spacing scale.

What spacing scale should I use for web UI design?▼

Use a linear scale of 4, 8, 16, 24, 32, 48, and 64 pixels rather than arbitrary values like 13px or 17px. Keep spacing within related groups smaller than spacing between groups, and start with too much white space before removing it.

How do I create a color palette for a web app?▼

Build 5-9 shades per color from near-white to near-black, and add subtle saturation to grays matching your UI temperature, such as a blue tint for cool interfaces. Design in grayscale first, then add color last so hierarchy does not depend on color alone.

Does this approach work with Tailwind CSS?▼

Yes, the principles map directly to Tailwind utilities like p-4 for spacing, text-gray-900 for text hierarchy, shadow-md for card elevation, and max-w-prose for readable text widths. The constrained scales align with Tailwind's default design tokens.

What contrast ratio is needed for readable body text?▼

Body text requires a minimum 4.5:1 contrast ratio, while large text at 18px or above needs at least 3:1. Use dark grays like #374151 on white backgrounds instead of lighter grays, and never rely on color alone to convey information.

When should I not use this design framework?▼

For typeface selection decisions, use a dedicated typography skill instead, and for usability audits, use a UX heuristics skill. This framework focuses on visual design systems rather than font pairing or interaction usability testing.