normalize

Audit and realign UI components to match design system tokens and patterns.

60|7|Updated Oct 18, 2020
One-click install
npx skills add https://github.com/bfree-trainer/bfree --skill normalize-bfree-trainer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: normalize
Source: https://github.com/bfree-trainer/bfree/tree/main/.claude/skills/normalize
Command: npx skills add https://github.com/bfree-trainer/bfree --skill normalize-bfree-trainer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill audits and realigns UI features that have drifted from the project's design system, fixing inconsistent spacing, hard-coded tokens, one-off components, and mismatched interaction patterns to restore visual and behavioral consistency across the product.

Core Features & Use Cases

  • Design system discovery: Find and interpret the project's design tokens, component conventions, spacing rules, and accessibility requirements.
  • Feature analysis: Identify deviations in pages, routes, and components, categorize cosmetic vs. functional issues, and determine root causes (missing tokens, bespoke implementations, or conceptual drift).
  • Normalization plan & execution: Replace custom UI with system components, apply design tokens for color/typography/spacing, align motion and responsive behavior, and enforce accessibility standards.
  • Cleanup & verification: Consolidate reusable components, remove orphaned code, run linting/type checks, and add tests or documentation to prevent regressions.
  • Use case: Bring a newly built feature or legacy page back into parity with the design system during a redesign, code review, or UI audit.

Quick Start

Run the normalize skill on the WorkoutPage component to audit its deviations and produce a prioritized plan to replace hard-coded styles with design tokens, swap bespoke elements for system components, and verify accessibility and responsive behavior.

Frequently Asked Questions about normalize

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

FAQPage Schema
How do I align UI components with a design system to fix inconsistent spacing and hard-coded styles?

To align UI components with a design system, audit pages and routes to replace hard-coded styles with design tokens, swap bespoke implementations for system components, and enforce accessibility and responsive behavior. This process corrects visual and behavioral drift.

What is the best way to refactor frontend features that use one-off components instead of design tokens?

The best way to refactor frontend features is to run a design system discovery audit, identify custom UI deviations, and execute a normalization plan that replaces one-off components with system components and applies correct design tokens for color, typography, and spacing.

When do I need to normalize a UI page during frontend development?

You need to normalize a UI page during frontend development when a newly built feature or legacy route exhibits conceptual drift, inconsistent styles, or mismatched interaction patterns during redesigns, code reviews, or UI audits.

Can I enforce accessibility and responsive behavior while replacing custom UI with system components?

Yes, you can enforce accessibility and responsive behavior while replacing custom UI. The normalization process explicitly aligns motion, interactions, and accessibility standards alongside swapping bespoke elements for system components.

How do I verify cleanup after realigning UI components to design system standards?

To verify cleanup after realigning UI components, consolidate reusable components, remove orphaned code, run linting and type checks, and add tests or documentation to prevent future regressions and ensure design system parity.

Why does my frontend feature have mismatched interaction patterns and inconsistent spacing?

Mismatched interaction patterns and inconsistent spacing occur due to conceptual drift, missing design tokens, or bespoke implementations that deviate from the project's design system during rapid development or legacy feature updates.