OpenParable
Skip to content
← Back to skills

Manage Color Contrast

Design
manage-color-contrast

Manage Color Contrast is an Agent Skill for design published in the gnurio/refactoring-ui-plugin repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Ensure WCAG AA accessibility and readability

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/gnurio/refactoring-ui-plugin/blob/HEAD/skills/09-manage-color-contrast/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/manage-color-contrast, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Skill: Manage Color Contrast

Purpose

Ensure text and interactive elements have sufficient contrast against their backgrounds for readability and accessibility.

Type

Evaluative + Corrective

Input

  • Text colors and sizes
  • Background colors
  • UI element specifications

Output

  • Contrast ratio calculations
  • Pass/Fail against WCAG standards
  • Recommendations for fixes

Transformation Performed

Calculates contrast ratios and ensures compliance with WCAG AA standards (4.5:1 for normal text, 3:1 for large text and UI components).

Decision Criteria

PASS (Good Contrast)

  • Normal text (< 18px): 4.5:1 minimum (WCAG AA)
  • Large text (≥ 18px bold or ≥ 24px): 3:1 minimum
  • UI components (buttons, inputs): 3:1 minimum for boundaries
  • Focus indicators: 3:1 minimum against adjacent colors

FAIL (Poor Contrast)

  • Light gray text on white (< 4.5:1)
  • White text on light colors
  • Disabled states that look like active (too much contrast)
  • Placeholder text same as input text

Contrast Ratio Quick Reference

Text Color on WhiteRatioPass AA?
#000000 (black)21:1✓
#33333312.6:1✓
#6666665.9:1✓
#7575754.6:1✓ (minimum)
#9999992.8:1✗
#CCCCCC1.6:1✗

Common Failure Modes

FailureDescriptionFix
Light Gray Text#999 or lighter for body textUse #666 minimum, #333 preferred
Ghost TextPlaceholder same as valueMake placeholder lighter (#999)
Low-contrast PrimaryBrand color too light for white textDarken brand color or use dark text
Subtle LinksLinks barely different from textAdd underline or increase contrast
Disabled ConfusionDisabled buttons too prominentReduce to 30% opacity or use gray
Icon FadeIcons too light to seeMatch text color or use higher contrast

Prerequisites

  • Color palette defined
  • Typography scale defined

Dependencies

  • build-color-palette (gray scale needed)

Refactoring UI References

  • "Don't use grey text on colored backgrounds"
  • "Ensure sufficient contrast"

Example Assessment

Input: Body text #888888 on white background

Evaluation: FAIL

  • Ratio: ~3.5:1
  • Below 4.5:1 requirement

Recommendation: Change to #666666 (5.9:1) minimum Prefer #333333 or #1A1A1A for body text