Color contrast, themes, dark mode, non-text contrast and color-only meaning.

MITAuto-check passedFrontend & Design

Install Contrast Master

skills CLI
$ npx skills add Community-Access/accessibility-agents --skill contrast-master -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Community-Access/accessibility-agents contrast-master --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Community-Access/accessibility-agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/contrast-master .claude/skills/contrast-master && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
contrast-master
GitHub stars
422
Token cost
~1.4k tokens
SKILL.md length
564 words
Files
6 (incl. references)
Skills in repo
108
Repo updated
First seen
Licence
MIT

At a glance

Color contrast, themes, dark mode, non-text contrast and color-only meaning.

  • Works in 6 steps: Check every text-on-background… → Do not assume that inverting colors… → Placeholder text often fails in dark… → …
  • Tasks that involve Theming and dark mode
  • SKILL.md covers Your Scope, WCAG AA Contrast Requirements, How to Check Contrast and Focus Indicators, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Contrast Master is an agent skill from Community-Access/accessibility-agents. Color contrast, themes, dark mode, non-text contrast and color-only meaning.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `agents/openai.yaml`, `examples/findings.json` and `references/color-independence.md`).

It sits in Frontend & Design, covering Theming and dark mode and Accessibility. The repository describes itself as: Accessibility review agents for Claude Code, GitHub Copilot, and Claude Desktop. Eleven specialists that enforce WCAG 2.2 AA compliance so AI coding tools stop generating… The licence is MIT.

When your agent uses it

  • Tasks that involve Theming and dark mode
  • Tasks that involve Accessibility

Example prompts

  • “/contrast-master”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Check every text-on-background combination in both themes
  2. Do not assume that inverting colors maintains contrast
  3. Placeholder text often fails in dark mode (gray on dark gray)
  4. Borders that were visible on white may disappear on dark backgrounds
  5. Shadows that provided depth on light mode do nothing on dark mode -- use borders instead
  6. Test focus indicators in both themes

What it can do on your machine

Read from SKILL.md and the folder at commit decf6ba. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are css and python).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Contrast Master loads about 1.4k tokens when it runs, and up to ~5.3k if it reads all its reference files. Until then it costs about 23 tokens; SKILL.md has 564 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Community-Access/accessibility-agents at commit decf6ba, republished under its MIT licence (© Community-Access). 564 words, ~1,449 tokens.

Download SKILL.mdSave it as .claude/skills/contrast-master/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
contrast-master
description
Color contrast, themes, dark mode, non-text contrast and color-only meaning.
license
MIT
disable-model-invocation
true
metadata.tier
specialist
metadata.domain
web
metadata.output
findings
metadata.effort
medium
metadata.title
Contrast Master

You are the color contrast and visual accessibility specialist. Color choices determine whether people can read an interface. You ensure every color combination meets WCAG AA standards and that visual design never excludes users.

Your Scope

You own everything visual that affects readability and perception:

  • Text color contrast ratios
  • UI component contrast (borders, icons, focus indicators)
  • Color-only information (status indicators, errors, charts)
  • Dark mode and theme implementation
  • Focus indicator visibility
  • Animation and motion safety
  • User preference media queries (prefers-* and forced-colors)

WCAG AA Contrast Requirements

These ratios are the minimum. Meeting them is mandatory, not aspirational.

Text Contrast (4.5:1 minimum)
  • Normal text (under 18px or under 14px bold): 4.5:1 against background
  • This applies to all text including placeholders, captions, timestamps, and secondary text
  • "It's just a caption" is not an excuse for low contrast
Large Text Contrast (3:1 minimum)
  • Large text (18px+ or 14px+ bold): 3:1 against background
  • Headings often qualify as large text but verify the actual rendered size
Non-Text Contrast (3:1 minimum)
  • UI components: buttons, inputs, checkboxes, toggles, cards
  • The component boundary must have 3:1 against adjacent colors
  • Focus indicators must have 3:1 against both the component and surrounding background
  • Icons that convey meaning (not decorative) need 3:1

How to Check Contrast

Use the WCAG contrast ratio formula. You can calculate or verify with a script:

python
import sys

def luminance(r, g, b):
    vals = []
    for v in [r, g, b]:
        v = v / 255.0
        vals.append(v / 12.92 if v <= 0.04045 else ((v + 0.055) / 1.055) ** 2.4)
    return 0.2126 * vals[0] + 0.7152 * vals[1] + 0.0722 * vals[2]

def contrast(hex1, hex2):
    r1, g1, b1 = int(hex1[1:3],16), int(hex1[3:5],16), int(hex1[5:7],16)
    r2, g2, b2 = int(hex2[1:3],16), int(hex2[3:5],16), int(hex2[5:7],16)
    l1, l2 = luminance(r1,g1,b1), luminance(r2,g2,b2)
    lighter, darker = max(l1,l2), min(l1,l2)
    return (lighter + 0.05) / (darker + 0.05)

fg = sys.argv[1]
bg = sys.argv[2]
ratio = contrast(fg, bg)
status = 'PASS' if ratio >= 4.5 else ('LARGE TEXT ONLY' if ratio >= 3.0 else 'FAIL')
print(f'{ratio:.2f}:1 -- {status}')

When auditing, extract all color values from CSS/Tailwind and check every text-on-background combination.

Focus Indicators

Every interactive element must have a visible focus indicator.

Requirements
  • Focus indicator must have 3:1 contrast against adjacent colors
  • Must be visible on both light and dark backgrounds
  • Minimum 2px outline recommended
  • Never use outline: none or outline: 0 without providing an alternative focus style
css
:focus-visible {
  outline: 2px solid #005fcc;
  outline-offset: 2px;
}
  • Use :focus-visible not :focus to avoid showing outlines on mouse click
  • outline-offset prevents the outline from overlapping content
  • Test on every background color used in the app
Dark Mode Focus
  • Light focus indicator on dark backgrounds
  • Consider using a double-ring technique for universal visibility:
css
:focus-visible {
  outline: 2px solid #ffffff;
  box-shadow: 0 0 0 4px #000000;
}
Show full SKILL.md (240 more words)Show less

Dark Mode

When implementing dark mode or themes:

  1. Check every text-on-background combination in both themes
  2. Do not assume that inverting colors maintains contrast
  3. Placeholder text often fails in dark mode (gray on dark gray)
  4. Borders that were visible on white may disappear on dark backgrounds
  5. Shadows that provided depth on light mode do nothing on dark mode -- use borders instead
  6. Test focus indicators in both themes

Animation and Motion

  • Support prefers-reduced-motion media query
  • No flashing content (3 flashes per second maximum, but prefer zero)
  • Provide controls to pause, stop, or hide any animation
  • Auto-playing content must have a visible stop mechanism
css
@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}

Tailwind-Specific Guidance

Common Tailwind classes that fail contrast on white backgrounds:

  • text-gray-400 (#9CA3AF) -- 2.85:1, FAILS
  • text-gray-500 (#6B7280) -- 4.64:1, passes AA normal text
  • text-gray-300 (#D1D5DB) -- 1.74:1, FAILS badly

Common Tailwind classes that fail on dark backgrounds (bg-gray-900 #111827):

  • text-gray-500 (#6B7280) -- 3.41:1, FAILS normal text
  • text-gray-400 (#9CA3AF) -- 5.51:1, passes
  • text-gray-600 (#4B5563) -- 2.11:1, FAILS

Always verify. Do not assume Tailwind color names indicate accessibility compliance.

Reference files

Read one only when the task reaches it. Do not read them all up front.

  • references/color-independence.md - Color Independence
  • references/user-preference-media-queries-prefers.md - User Preference Media Queries (prefers-*), WCAG 2.2 Visual Requirements
  • references/validation-checklist.md - Validation Checklist, Structured Output for Sub-Agent Use

Output contract

Return only JSON matching skills/a11y-core/schemas/findings.schema.json. No prose, no summary, no restated instructions. One object, one array of findings.

Shared rules, dispatch contract and schemas: skills/a11y-core/SKILL.md. Authoritative specifications for this skill: skills/a11y-core/references/sources.md.

© Community-Access, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (references) in skills/contrast-master of Community-Access/accessibility-agents.

  • SKILL.md
  • agents/openai.yaml
  • examples/findings.json
  • references/color-independence.md
  • references/user-preference-media-queries-prefers.md
  • references/validation-checklist.md

Open the folder on GitHubat commit decf6ba

Compare with similar skills

Contrast Master next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Contrast Master compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Contrast Master this skillCommunity-Access/accessibility-agents422—~1.4kAutomated safety check: PassMIT
Color Auditrome-os/rome725—~2.7kAutomated safety check: PassMIT
Ant Designkqcoxn/MaaPipelineEditor4081 repos~1.1kAutomated safety check: PassMIT
Better Colorstrycompai/crm11k—~1.9kAutomated safety check: PassMIT
Data-Dense Dashboard Designerplugin87/ux-ui-agent-skills1.5k—~2.6kAutomated safety check: PassMIT
Material Design 3 UI/UX Guideskydashnet/material-design-3-ui-skill130—~3kAutomated safety check: PassMIT

Similar skills

  • Color Audit

    rome-os/rome

    Audit a design system's color palette against measurable color-science disciplines — WCAG/APCA contrast of declared token pairs, perceptual (OKLCH) ramp uniformity, color-blindness safety of…

    725 GitHub stars~2.7k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Ant Design

    kqcoxn/MaaPipelineEditor

    Decision guide for antd 6.x, Ant Design Pro 5/ProComponents, Ant Design X v2, and the offline @ant-design/cli.

    408 GitHub starsUsed in 1 repo~1.1k tokens
    Frontend & DesignAuto-check passed
  • Better Colors

    trycompai/crm

    OKLCH color space and color usage for web projects. An agent skill from trycompai/crm.

    11k GitHub stars~1.9k tokensUpdated 27 days ago
    Frontend & DesignAuto-check passed
  • Data-Dense Dashboard Designer

    plugin87/ux-ui-agent-skills

    Lays out dense analytics or trading-terminal screens in banded sections with hand-drawn SVG charts, instead of a wall of identical stat cards.

    1.5k GitHub stars~2.6k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Material Design 3 UI/UX Guide

    skydashnet/material-design-3-ui-skill

    Guides designing, reviewing or implementing interfaces that follow Google's Material Design 3 system: semantic tokens, component states, adaptive layout and accessibility.

    130 GitHub stars~3k tokensUpdated 8 days ago
    Frontend & DesignAuto-check passed
  • Blog Chart

    AgriciDaniel/claude-blog

    Generate dark-mode-compatible inline SVG data visualization charts for blog posts.

    2.3k GitHub starsUsed in 1 repo~2.4k tokens
    Frontend & DesignAuto-check passed

More from Community-Access/accessibility-agents

All 108 skills in this repo
  • A11y Core

    Community-Access/accessibility-agents

    Shared contract for the Accessibility Agents skills - dispatch, findings schema, report rules.

    422 GitHub stars~1.2k tokensUpdated 15 days ago
    Auto-check passed
  • Kb Web Scanning

    Community-Access/accessibility-agents

    Reference data, not a reviewer. An agent skill from Community-Access/accessibility-agents.

    422 GitHub stars~1.2k tokensUpdated 15 days ago
    Auto-check passed
  • Accessibility Lead

    Community-Access/accessibility-agents

    Web UI accessibility lead. An agent skill from Community-Access/accessibility-agents.

    422 GitHub stars~932 tokensUpdated 15 days ago
    Auto-check passed
  • Alt Text Headings

    Community-Access/accessibility-agents

    Alt text, SVGs, figures, charts, heading order, page titles and landmarks.

    422 GitHub stars~1.5k tokensUpdated 15 days ago
    Auto-check passed
  • Aria Specialist

    Community-Access/accessibility-agents

    ARIA roles, states and properties for custom widgets and dynamic content.

    422 GitHub stars~1.6k tokensUpdated 15 days ago
    Auto-check passed
  • Cognitive Accessibility

    Community-Access/accessibility-agents

    Plain language, WCAG 2.2 cognitive criteria, COGA guidance and auth UX.

    422 GitHub stars~1.4k tokensUpdated 15 days ago
    Auto-check passed

Questions about Contrast Master

What does Contrast Master do?

Color contrast, themes, dark mode, non-text contrast and color-only meaning. Contrast Master is an agent skill from Community-Access/accessibility-agents. Color contrast, themes, dark mode, non-text contrast and color-only meaning.

When should I use Contrast Master?

Contrast Master fits situations like: tasks that involve Theming and dark mode; tasks that involve Accessibility.

How do I install Contrast Master in Claude Code?

Run `npx skills add Community-Access/accessibility-agents --skill contrast-master -a claude-code`. Or copy the skill folder (skills/contrast-master in Community-Access/accessibility-agents) into .claude/skills/contrast-master in your project. Claude Code loads it when a task matches its description.

How do I install Contrast Master in Codex?

Run `npx skills add Community-Access/accessibility-agents --skill contrast-master -a codex`. Or copy the skill folder (skills/contrast-master in Community-Access/accessibility-agents) into .agents/skills/contrast-master in your project. Codex loads it when a task matches its description.

Can I use Contrast Master in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Community-Access/accessibility-agents --skill contrast-master -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/contrast-master, .gemini/skills/contrast-master, .github/skills/contrast-master and .opencode/skills/contrast-master in your project.

What does Contrast Master need to run?

SKILL.md names no scripts, command-line tools or credentials: Contrast Master is instructions for the agent only. Our summary lists: Python 3.

Does Contrast Master access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Contrast Master safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Contrast Master use?

Contrast Master is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Contrast Master use?

About 1.4k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.9k tokens, read only when the agent opens those files.

What are the alternatives to Contrast Master?

Skills that share tags, products or a category with Contrast Master: Color Audit (rome-os/rome, 725 stars), Ant Design (kqcoxn/MaaPipelineEditor, 408 stars), Better Colors (trycompai/crm, 11k stars) and Data-Dense Dashboard Designer (plugin87/ux-ui-agent-skills, 1.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Contrast Master?

Community-Access (a GitHub organization) maintains it in Community-Access/accessibility-agents, which has 422 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on September 23, 2026.

Source: Community-Access/accessibility-agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.