color-accessibility-expert

Color accessibility expert

Overview

Detect and fix WCAG color contrast across a repo. The primary outcome is a set of source files whose colors all pass: locate color literals, measure their contrast ratios, compute hue-preserving replacements for the failing ones, and apply those replacements directly to the source files with apply_color_fixes.py. Then re-audit to confirm every color passes, optionally spot-check contrast in rendered images, and record the audited result in docs/PALETTE_CONTRAST_AUDIT.md from evidence gathered during the current run. The audit file documents the fix; the fixed source is the deliverable.

Behavioral contract

This skill edits exactly two kinds of target-repo files, and both are first-class outcomes:

• Color values in source files -- the primary deliverable. During a fix run (steps 3 and 4 below), replace each failing hex with the value adjust_color.py or audit_palette.py computes, applied through apply_color_fixes.py. This is the surface where the accessibility problem actually gets fixed.
• docs/PALETTE_CONTRAST_AUDIT.md -- the per-repo palette audit that documents the fixed result. Write or refresh that file only through generate_palette_audit.py.

The generic WCAG method doc, docs/COLOR_CONTRAST_ACCESSIBILITY.md, is propagated read-only from starter-repo-template and assumed present. Cite it from the audit file, but never write it here.

Treat every other file in the target repo as read-only reference for this skill's own scripts, references, and generated output.

Ground every file path and color value in the generated audit table in files Read during the current run: the "Evidence rule" section below states the exact standard.

Project shape

Before step 1, frame the target: improve-existing (the repo has colors to audit and fix -- the common case) versus greenfield (the repo needs a palette created). Detection and both paths live in references/project_workflow.md. Classify one-off requests (single pair, one color, one image) with references/task_selection.md; route observed symptoms through references/topic_index.md.