What problem does it solve?
Many frontend features drift away from the established design system, producing inconsistent typography, colors, spacing, and component behavior that harm usability and maintenance. This Skill provides a structured process to discover those deviations, diagnose root causes, and produce a prioritized plan to align the feature with system tokens, components, and interaction patterns.
Core Features & Use Cases
- Design system discovery: Locate and interpret style guides, component libraries, tokens, and conventions used across the project.
- Gap analysis & planning: Identify cosmetic vs. functional inconsistencies, root causes (hard-coded values, one-off components), and define an actionable normalization plan.
- Execution checklist: Replace one-off styles with tokens, swap custom elements for system components, standardize spacing/typography, ensure responsive rules and motion match patterns, and verify accessibility and tests.
- Cleanup & consolidation: Consolidate reusable components into the design system, remove orphaned code, and run linting/type-checks to prevent regressions.
- Use case: Harmonize a legacy signup flow with the live design system by replacing hard-coded styles, swapping custom inputs for system inputs, and validating contrast and keyboard focus.
Quick Start
Normalize the "signup" form to match the project's design system by replacing hard-coded styles with tokens, swapping custom controls for system components, and listing remaining gaps and tests required.