Agent skill

Refactoring UI Skill: Visual Design Rules for AI Agents

The Refactoring UI skill turns the book's principles into an agent skill covering hierarchy, type, color, spacing, dark mode and forms, with named alternatives to common AI defaults.

Install
git clone https://github.com/jaywilburn/refactoring-ui-skill.git ~/.agents/skills/refactoring-ui
View on GitHub

Stars, license and last push from GitHub. Install count as reported by the open skills directory.

What is the Refactoring UI skill?

The Refactoring UI skill is an agent skill by jaywilburn based on the Refactoring UI book. It tells an AI coding agent how to handle visual hierarchy, typography, color, spacing, shadows, dark mode, forms and animation, and it names AI default patterns such as purple gradients and gives alternatives.

It is an opinionated agent skill for building professional UI without a designer, based on the Refactoring UI principles by Adam Wathan and Steve Schoger. The README says it does not replace the book and recommends reading it.

The skill is organised in two layers. A design thinking layer makes strategic choices first, such as personality, color theory and layout. An execution layer then covers hierarchy, type, spacing, depth and forms.

What changes in your agent's output

  • Emphasis comes from size, weight and color rather than from adding more boxes or borders.
  • Palettes are built in HSL with UI states, and gray is chosen as warm or cool to match the product.
  • Layouts are picked from the content and the domain, and the same component is styled differently by context.
  • Dark mode is treated as a system with surface hierarchy and saturation shifts, not inverted colors.
  • Named AI defaults such as purple gradients, SaaS templates and uniform card grids get concrete alternatives.

Who it is for

Best for

  • Developers who ship UI without a designer and want an agent to apply sound spacing, type and color rules.
  • Teams who see the same generic look in every agent-built page and want a counterweight.
  • Anyone who wants a design audit checklist, paired with a reviewer like critique or a full-page skill like ui-ux-pro-max.

Not for

  • People who want measured checks. The README describes guidance, not an automated audit or a browser test.
  • Teams with a strict brand system, where the brand rules should win over general taste.
  • Readers hoping to skip the book. The README says plainly that it does not replace it.

Use it with UiChemy

Run the skill on a page design before you convert it, then use UiChemy Figma to WordPress to turn the finished design into an editable page. Click Get Started on uichemy.com.