What problem does it solve? Design systems often lock color tokens that pass a casual eyeball check but fail WCAG contrast requirements when applied to real text, UI components, or focus indicators, forcing expensive multi-component rewrites late in the project. This Skill catches those failures before tokens lock by auditing every documented foreground/background pair. ## Core Features & Use Cases - Pairwise contrast matrix: Computes WCAG 2.2 contrast ratios for every documented foreground/background token pair across light and dark themes, writing one row per pair to CONTRAST_AUDIT.md with no silent omissions. - Context-aware thresholds: Scores each pair against the correct threshold for its design context (normal text, large text, UI components, focus indicators, graphical objects), applying the strictest threshold for multi-context pairs. - Token-level remediation: For every failing pair, proposes a concrete fix such as a hex value adjustment, a context reclassification, or a documented deferral, and stages PROPOSED blocks for DECISIONS.md and IMPLEMENTATION_PLAN.md. - Use Case: Before locking a new design system's color palette, run this audit to verify that the proposed primary text color on the surface background meets 4.5:1 for body text in both light and dark themes, and receive exact token deltas for any pair that fails. ## Quick Start Audit all color token pairs in my design system's foundations/color.md against WCAG 2.2 AA for both light and dark themes and write the contrast matrix to the task folder.
