Agent skill

Color Contrast Auditor Skill for WCAG Checks

The color-contrast-auditor skill finds text and UI color pairs that fail WCAG 2.1 ratios in CSS, Tailwind or screenshots, then proposes replacement colors that pass.

Install
git clone https://github.com/curiositech/some_claude_skills.git
View on GitHub

Stars, license and last push from GitHub. Install count as reported by the open skills directory.

What is the color contrast auditor skill?

Color-contrast-auditor is a skill in the curiositech skills collection on GitHub. It has an AI coding agent find color pairs that fail WCAG 2.1 contrast in CSS, Tailwind classes or screenshots, calculate each ratio, and suggest hex values that pass, with before and after numbers.

It is a skill in the curiositech/some_claude_skills collection. It detects and fixes color contrast violations using WCAG 2.1 guidelines, combining the contrast ratio formula with perceptual review of screenshots through the agent's vision.

What it checks

  • Normal text against 4.5:1 and large text against 3:1, with AAA targets of 7:1 and 4.5:1.
  • UI components, icons, focus indicators and form field borders against 3:1.
  • Failing patterns it names: light on light text, gray on white, saturated colors that look bright, trendy low contrast minimalism, placeholder text and gradient backgrounds.
  • Color blindness cases such as red and green, with a rule never to rely on color alone.

What the report looks like

The audit extracts colors from CSS or Tailwind classes, calculates each ratio, and writes a report with totals, failures grouped by severity, and a table of location, colors, ratio, requirement and a replacement color that passes.

Who the skill is for

Best for

  • Pre-launch accessibility checks on a stylesheet or a design system's tokens.
  • Reviewing a screenshot when someone says text is hard to read.
  • Developers who want passing hex values, not only a failure flag.

Not for

  • Choosing brand colors or palette harmony, which the SKILL.md sends to other skills.
  • Non-visual accessibility such as screen readers and keyboard navigation.
  • Pages whose backgrounds are photos, where a sampled composite is needed beyond a color pair.

Use web-accessibility-skill for the non-visual half of an audit and color-system to build tonal scales that pass from the start.

Use it with UiChemy

Run the audit on the colors of a WordPress page built with UiChemy, then change the failing values in Elementor or Gutenberg. Click Get Started on uichemy.com.