normalize

Audit and realign frontend UI components to design system tokens, spacing, colors, and typography.

3|3|Updated Aug 19, 2025
One-click install
npx skills add https://github.com/StartaleGroup/app-sdk --skill normalize-startalegroup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: normalize
Source: https://github.com/StartaleGroup/app-sdk/tree/main/.claude-lib/shared/skills/normalize
Command: npx skills add https://github.com/StartaleGroup/app-sdk --skill normalize-startalegroup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits and realigns UI to match design system standards, spacing, tokens, and patterns. Use when the user mentions consistency, design drift, mismatched styles, tokens, or wants to bring a feature back in line with the system.

Core Features & Use Cases

  • Mandatory preparation: Invoke /frontend-design — it contains design principles, anti-patterns, and the Context Gathering Protocol. Follow the protocol before proceeding — if no design context exists yet, you MUST run /teach-impeccable first.
  • Plan: Deeply understand the context by discovering the design system, analyzing the current feature, and creating a normalization plan.
  • Execute: Address typography, color & theme, spacing & layout, components, motion & interaction, responsive behavior, accessibility, and progressive disclosure.
  • Clean Up: Consolidate reusable components, remove obsolete code, verify quality, and ensure DRYness.
  • Never: Do not create new one-off components when design system equivalents exist, do not hard-code values that should use tokens, do not introduce patterns that diverge from the design system, and do not compromise accessibility for visual consistency.

Quick Start

Run the design-system normalization workflow on the target feature by performing the mandatory preparation and then executing the Plan, Execute, and Clean Up steps.

Frequently Asked Questions about normalize

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

FAQPage Schema
How do I fix UI inconsistencies and design drift in my frontend components?

Fix UI inconsistencies by auditing frontend pages and realigning components to your design system standards. This normalization process updates tokens, spacing, colors, and typography to resolve design drift and ensure UI consistency across ongoing feature work.

What's the best way to normalize typography and color tokens across a web application?

The best way to normalize typography and color tokens is to create a normalization plan that maps mismatched styles to design system equivalents. Execute token updates across components, replace hard-coded values, and verify accessibility to maintain UI consistency.

Do I need existing design context before realigning UI components to design system standards?

Yes, you need existing design context before realigning UI components. You must follow a Context Gathering Protocol to discover design principles and anti-patterns. If no design context exists, you are required to run a setup process to establish it first.

How do I ensure DRYness and maintainability after a design system refresh?

Ensure DRYness and maintainability after a design system refresh by performing a final cleanup. Consolidate reusable components, remove obsolete code, verify quality, and never create new one-off components when design system equivalents already exist.

When should I avoid hard-coding values during UI normalization?

You should avoid hard-coding values during UI normalization whenever those values represent tokens, spacing, or colors that belong in the design system. Introducing hard-coded patterns diverges from the system and compromises long-term maintainability and accessibility.