agentsclimarketplace

09 manage color contrast

Skill gnurio/refactoring-ui-plugin/skills/09-manage-color-contrast

Ensure WCAG AA accessibility and readabilityFrom its SKILL.md

Install
npx -y skills add gnurio/refactoring-ui-plugin --skill 09-manage-color-contrast

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.

SKILL.md

2.6 KB, as published. Nobody here has run it

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

Keep looking

Skills are one crate of 613,373. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.