normalize

Normalize UI features to match a project's design system using tokens and components.

Updated Jan 22, 2025
One-click install
npx skills add https://github.com/SL-A-SH/my-portfolio --skill normalize-sl-a-sh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: normalize
Source: https://github.com/SL-A-SH/my-portfolio/tree/main/.claude/skills/normalize
Command: npx skills add https://github.com/SL-A-SH/my-portfolio --skill normalize-sl-a-sh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many UI features drift away from a project's established design system, producing inconsistent visuals, duplicated one-off components, fragile styles, and accessibility regressions; this Skill guides a systematic redesign to restore consistency and usability.

Core Features & Use Cases

  • Design System Discovery: Locate and interpret design tokens, component guidelines, and style conventions so changes are grounded in the source of truth.
  • Feature Analysis & Plan: Audit a page, route, or component to identify cosmetic vs functional inconsistencies and produce a prioritized normalization plan.
  • Execution & Cleanup: Replace hard-coded styles with tokens, swap custom UI with design-system components, ensure responsive behavior and accessibility, and remove orphaned code while verifying linting and tests.
  • Use Case: Convert a bespoke landing-page hero section to use shared design tokens and system components to improve maintainability, accessibility, and visual harmony.

Quick Start

Normalize the homepage hero feature to match the repository's design system by running the frontend-design context protocol, replacing hard-coded styles with tokens, swapping in design-system components, and verifying accessibility and responsiveness.

Frequently Asked Questions about normalize

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

FAQPage Schema
How do I normalize UI components to match an existing design system?

To normalize UI components, you replace hard-coded styles with design tokens and swap bespoke UI for design-system components. This involves auditing pages or routes for inconsistencies, substituting styles, and verifying accessibility and responsive behavior.

What is the best way to replace hard-coded styles with design tokens during a frontend refactor?

Replacing hard-coded styles with design tokens requires discovering the project's established style conventions first. You then audit the feature, substitute inline values with the correct tokens, and replace custom elements with system components to restore visual consistency.

Why do my UI features drift away from the project's design system and how can I fix it?

UI features drift away from the design system when duplicated one-off components and fragile styles accumulate. You can fix this by running a systematic normalization that locates design tokens, replaces custom UI, and removes orphaned code while verifying linting and tests.

Can I use design system normalization for a component library migration?

Yes, design system normalization is effective for component library migrations. It guides the systematic replacement of custom UI elements with design-system components, ensures accessibility checks are performed, and cleans up orphaned code during the migration process.

Does normalizing a UI feature include accessibility and responsive adjustments?

Yes, normalizing a UI feature includes both accessibility checks and responsive adjustments. The execution phase ensures that after substituting hard-coded styles with tokens, the updated components maintain proper accessibility compliance and adapt correctly across different screen sizes.