color-accessibility — Claude Code skill: what it does, how to install
Guides accessible palette design under WCAG AA and AAA standards, including support for color blindness. Helps style interfaces, charts, and form states.
npx skills add aj-geddes/useful-ai-prompts --skill color-accessibility -a claude-codeWhat color-accessibility does
The skill provides rules for designing color schemes that meet WCAG accessibility standards. It guides the agent through calculating relative luminance contrast ratios and adapting graphics for people with color vision deficiency. Reference documents inside cover contrast standards and validation workflows.
For WCAG AA compliance, normal text needs at least a 4.5:1 ratio, while UI elements and large text require 3:1. The stricter AAA standard demands 7:1 for normal text. Mixing over 8 colors is discouraged. Pure red and green pairings are explicitly avoided.
Color must never be the only indicator of system state. Statuses and form validation require explicit labels or icons to stay readable for color-blind users.
What it helps with
- calculate contrast ratios to satisfy WCAG AA or AAA guidelines
- design form states and indicators without relying solely on color
- adapt charts and visualizations for users with color vision deficiency
- assemble an interface palette without conflicting red-green pairings
Example prompts for the agent
- Check our form colors against WCAG AA contrast guidelines.
- Suggest a chart palette that remains distinct for users with red-green color blindness.
- Update our status badges to include icons and text labels alongside color.
How to install color-accessibility
1Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill color-accessibility -a claude-code2Manually: put the files in place
~/.claude/skills/color-accessibility/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/color-accessibility/
1Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill color-accessibility -a codex2Manually: put the files in place
.agents/skills/color-accessibility/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill color-accessibility -a cursor2Manually: put the files in place
.cursor/skills/color-accessibility/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install aj-geddes/useful-ai-prompts color-accessibility2Manually: put the files in place
.github/skills/color-accessibility/SKILL.md1Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill color-accessibility -a gemini-cli2Platform CLI
gemini skills install https://github.com/aj-geddes/useful-ai-prompts --path skills/color-accessibilityManually: put the files in place
.devin/skills/color-accessibility/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add aj-geddes/useful-ai-prompts --skill color-accessibility -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about color-accessibility
How to install color-accessibility in Claude Code?
Run npx skills add aj-geddes/useful-ai-prompts --skill color-accessibility -a claude-code. You can also place the file manually at ~/.claude/skills/color-accessibility/SKILL.md.
What does the color-accessibility skill do?
It provides guidelines for WCAG contrast ratios and accessible UI design. The skill helps agents simulate color blindness and select distinguishable color pairings.
Which contrast thresholds does the skill specify?
For WCAG AA, ordinary text requires a minimum ratio of 4.5:1, while large text and interface elements need 3:1. The WCAG AAA level sets the requirement for normal text at 7:1.
Source text
SKILL.md · MIT
--- name: color-accessibility description: > Design color palettes that are accessible to all users including those with color blindness. Ensure sufficient contrast, meaningful use of color, and inclusive design. --- # Color Accessibility ## Table of Contents - [Overview](#overview) - [When to Use](#when-to-use) - [Quick Start](#quick-start) - [Reference Guides](#reference-guides) - [Best Practices](#best-practices) ## Overview Accessible color design ensures all users, including those with color vision deficiency, can access and understand information. ## When to Use - Creating color palettes - Designing data visualizations - Testing interface designs - Status indicators and alerts - Form validation states - Charts and graphs ## Quick Start Minimal working example: ```yaml WCAG Contrast Ratios: WCAG AA (Minimum): - Normal text: 4.5:1 - Large text (18pt+): 3:1 - UI components & graphical elements: 3:1 - Focus indicators: 3:1 WCAG AAA (Enhanced): - Normal text: 7:1 - Large text: 4.5:1 - Better for accessibility --- Testing Contrast: Tools: - WebAIM Contrast Checker - Color Contrast Analyzer - Figma plugins - Browser DevTools Formula (WCAG): Contrast = (L1 + 0.05) / (L2 + 0.05) Where L = relative luminance // ... (see reference guides for full implementation) ``` ## Reference Guides Detailed implementations in the `references/` directory: | Guide | Contents | |---|---| | [Color Contrast Standards](references/color-contrast-standards.md) | Color Contrast Standards | | [Color Vision Deficiency Simulation](references/color-vision-deficiency-simulation.md) | Color Vision Deficiency Simulation | | [Accessible Color Usage](references/accessible-color-usage.md) | Accessible Color Usage | | [Testing & Validation](references/testing-validation.md) | Testing & Validation | ## Best Practices ### ✅ DO - Ensure 4.5:1 contrast minimum (WCAG AA) - Test with color blindness simulator - Use patterns or icons with color - Label states with text, not color alone - Test with real users with color blindness - Document color usage in design system - Choose accessible color palettes - Use sequential colors for ordered data - Validate all color combinations - Include focus indicators ### ❌ DON'T - Use color alone to convey information - Create low-contrast text - Assume users see colors correctly - Use red-green combinations - Forget about focus states - Mix too many colors (>5-8) - Use pure red and pure green together - Skip contrast testing - Assume AA is sufficient (AAA better) - Ignore color blindness in testing
© aj-geddes · MIT · aj-geddes/useful-ai-prompts