color-contrast

Validate WCAG 2.1 color contrast ratios and suggest compliant alternatives.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/ChoreShore/Version1 --skill color-contrast-choreshore
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: color-contrast
Source: https://github.com/ChoreShore/Version1/tree/main/.windsurf/skills/color-contrast
Command: npx skills add https://github.com/ChoreShore/Version1 --skill color-contrast-choreshore

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify and fix color combinations that fail WCAG 2.1 contrast requirements so text and UI elements remain legible and accessible across devices and sizes.

Core Features & Use Cases

  • Contrast validation: Calculate relative luminance and contrast ratios for any foreground/background pair and report AA and AAA compliance for normal and large text.
  • Accessible suggestions: Recommend the closest compliant color adjustments (darken/lighten) to meet target contrast thresholds.
  • Palette and batch checks: Evaluate entire color scales or token sets, output contrast matrices, and highlight problematic pairs for designers and developers.
  • Integration scenarios: Use during brand design reviews, front-end styling updates, or automated accessibility audits to ensure buttons, text, and UI components meet contrast rules.

Quick Start

Use the color-contrast skill to check #6b7280 on #ffffff and return the contrast ratio, AA/AAA pass-fail results for normal and large text, and suggested compliant color alternatives.

Frequently Asked Questions about color-contrast

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

FAQPage Schema
How do I check if my color contrast meets WCAG 2.1 accessibility standards?

To check WCAG compliance, you compute the relative luminance of your foreground and background colors to determine the exact contrast ratio. This validates your color contrast against WCAG 2.1 AA and AAA thresholds for both normal and large text.

How do I fix a color palette that fails WCAG contrast requirements?

To fix a failing color palette, you can use accessibility suggestions that recommend the closest compliant color adjustments. The skill automatically darkens or lightens the original colors to meet your target AA or AAA contrast thresholds while preserving your brand identity.

Can I batch check an entire color scale or design token set for accessibility?

Yes, you can batch check an entire color scale or design token set for accessibility. The skill evaluates full palettes, outputs detailed contrast matrices, and highlights problematic foreground and background color pairs that fail WCAG 2.1 contrast requirements.

What is the minimum color contrast ratio needed for large text to pass AA?

The minimum color contrast ratio needed for large text to pass AA is evaluated alongside normal text requirements. By computing relative luminance per WCAG 2.1 guidelines, the skill explicitly reports pass or fail status for AA and AAA levels across both normal and large text sizes.

Does this color contrast checker work for both web and app design workflows?

Yes, this color contrast checker works for both web and app design workflows. It applies to front-end styling updates and brand design reviews to ensure that text, buttons, and UI components remain legible and accessible across different devices and sizes.