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.
How to install Color Contrast Auditor Skill for WCAG Checks
git clone https://github.com/curiositech/some_claude_skills.gitThe skill declares read, write, edit, web fetch, glob and grep tools in its SKILL.md, so it can edit files when you ask for fixes.Clone the repository
Run
git clone https://github.com/curiositech/some_claude_skills.git. The skill is the .claude/skills/color-contrast-auditor folder.Copy the skill folder
Copy .claude/skills/color-contrast-auditor into your AI coding agent's skills folder.
Point it at your styles
Open a project with CSS or Tailwind files, or attach a screenshot of the page to review.
Ask for an audit
Say something like check contrast on this page and read the severity report.
Check that it loaded
Ask it to audit a page with light gray body text on white. The report should list the pair with a ratio under 4.5:1 and propose a darker gray that passes.
Key features
- WCAG 2.1 thresholdsHolds the AA and AAA ratios for normal text, large text, UI components and graphical objects.
- Ratio calculationIncludes the relative luminance and contrast ratio formulas so each color pair is computed, not eyeballed.
- Failing pattern catalogueNames six common failures such as gray text on white, coral on warm white and placeholder text.
- Screenshot analysisIdentifies text by size, interactive elements and red flags such as text over images without an overlay.
- Color extractionGives search commands to find color declarations in CSS and text or background classes in Tailwind files.
- Severity reportWrites a markdown report with summary counts and failures grouped by ratio severity.
- Concrete fixesSuggests specific replacement hex values and states the new ratio for each.
- Color blindness notesLists deuteranopia, protanopia and tritanopia cases and says to add icons or labels beside color.
- Release checklistEnds with a pre-ship checklist covering body text, large text, borders, icons, placeholders, focus states and links.
Frequently asked questions
What is the color contrast auditor skill?
It is a skill in the curiositech/some_claude_skills collection that finds color pairs failing WCAG 2.1 contrast and suggests passing replacements. It works from CSS, Tailwind classes or screenshots and produces a report grouped by severity.
How do I install color-contrast-auditor?
Clone curiositech/some_claude_skills and copy the .claude/skills/color-contrast-auditor folder into your agent's skills folder. The repository README also describes a plugin route for installing individual skills, or the whole collection, and a manual copy route.
Which WCAG ratios does it use?
AA needs 4.5:1 for normal text and 3:1 for large text, UI components and graphical objects. AAA raises normal text to 7:1 and large text to 4.5:1. The skill lists all of these in a table.
Can it check a screenshot?
Yes. The SKILL.md says to activate on screenshots with suspected contrast issues. It sorts text by size, looks at buttons, borders and icons, and flags light on light text and text over images without an overlay.
Does it cover color blindness?
It adds notes on deuteranopia, protanopia and tritanopia, says contrast ratios help but do not cover everything, and tells you never to rely on color alone. Add icons or text labels for error and success states.
What is it not meant for?
The skill says it is not for general color theory, brand color selection or non-visual accessibility such as screen readers and keyboard navigation. It redirects those jobs to other skills in the same collection.
How does it differ from a general accessibility skill?
This one stays on color alone. For keyboard, landmark and screen reader work use accessibility-audit, and use better-colors when you need to design a new palette rather than audit an existing one.


