normalize

Align a feature's UI with design system tokens, components, and patterns.

Updated Dec 18, 2025
One-click install
npx skills add https://github.com/l0lxl0lw/dotfiles --skill normalize-l0lxl0lw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: normalize
Source: https://github.com/l0lxl0lw/dotfiles/tree/main/ai/shared/skills/impeccable/normalize
Command: npx skills add https://github.com/l0lxl0lw/dotfiles --skill normalize-l0lxl0lw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Features often drift from the design system through one-off components, hard-coded values, and inconsistent patterns. This Skill audits a page, route, or feature and rewrites it to match established design tokens, components, and UX conventions. ## Core Features & Use Cases - Design System Discovery: Searches the repository for style guides, component libraries, and design tokens before making any change, and asks when principles are unclear. - Multi-Dimension Normalization: Systematically fixes typography, color, spacing, components, motion, responsive behavior, accessibility, and progressive disclosure to match the design system. - Cleanup and Verification: Consolidates reusable components, removes orphaned code, and runs lint, type-check, and tests after refactoring. - Use Case: A settings page was built with custom buttons and hard-coded hex colors. Run normalize on it to replace them with design system components and tokens, then verify nothing regressed. ## Quick Start Ask the AI to normalize the settings page so it matches the design system.

Frequently Asked Questions about normalize

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

FAQPage Schema
How do I make a page consistent with my design system?

Run the normalize skill on the page or feature. It first discovers your design system documentation and tokens, then replaces one-off components and hard-coded values with design system equivalents across typography, color, spacing, and layout.

What does design system normalization cover?

Normalization covers typography, color and theme tokens, spacing and layout, component replacement, motion and interaction timing, responsive breakpoints, accessibility attributes, and progressive disclosure patterns. It also removes orphaned code left over after refactoring.

Does normalize work without existing design system documentation?

No. The skill requires design context before proceeding. If no design system documentation exists in the repository, it directs you to run the teach-impeccable skill first to establish that context.

Can normalize introduce new components during refactoring?

It avoids creating one-off components when design system equivalents exist. If a genuinely reusable new component is created, the cleanup phase moves it into the shared UI component path rather than leaving it local to the feature.

How is quality verified after UI normalization?

After normalization, the skill runs lint, type-check, and tests according to the repository's guidelines. It also checks for duplication introduced during refactoring and consolidates it to keep the code DRY.