xxd-accessible-color

name	xxd-accessible-color
description	Check and repair Chinese traditional color combinations for readability and accessibility. Use when a user asks whether text, buttons, UI states, charts, light mode, dark mode, or traditional color palettes meet contrast and non-color-cue requirements.

xxd-accessible-color

Purpose

Use this skill when color beauty has to survive real reading, interaction, status, or chart use. It should return testable contrast decisions and repairs from the same 742-color system.

Pain Points This Solves

• Traditional colors that look elegant can fail as body text, buttons, focus rings, or chart distinctions.
• Teams often use color alone to communicate status, selection, or error.
• Accessibility feedback is easy to make vague; this skill must give ratios, pass states, and concrete replacements.

Data Contract

• Use the bundled references inside this skill for replacements:
  • references/chinese-color-master-list.md: full 742-color Markdown source list.
  • references/chinese-color-harmony.csv: complete machine-readable harmony table for all 742 colors.
  • references/chinese-color-harmony.md: Markdown version of the same harmony relationships.
• Use WCAG contrast ratios for text and UI pair evaluation.
• Do not claim compliance without a ratio or a clear "needs verification" note.
• For charts, status, and selections, check whether color is the only cue and add labels, shape, stroke, underline, icon, or pattern when needed.

Evaluation Workflow

1. Identify the role:
   • Normal text, large text, button label, icon, focus ring, border, chart series, status, selection, or decoration.
2. Build test pairs:
   • Foreground/background for text.
   • State pairs for interactive elements.
   • Adjacent colors for charts and legends.
3. Calculate contrast when HEX values are available.
4. Classify:
   • Pass: usable as requested.
   • Conditional: usable for large text, decoration, non-critical marks, or with added cues.
   • Fail: needs replacement.
5. Repair failures:
   • Preserve the intended temperature and cultural signal where possible.
   • Prefer nearby, neutral, gray-toned, light, dark, or harmony-related project colors.
   • Keep the replacement inside the 742-color dataset.
6. Add non-color cues when meaning depends on status, selection, chart distinction, or warnings.

Thresholds

• Normal text: target at least 4.5:1.
• Large text: target at least 3:1.
• UI components and graphical objects: target at least 3:1 when contrast carries function.
• Do not use color alone to communicate required meaning.

Output Shape

• Summary: pass, conditional, fail counts and biggest risk.
• Pair table: foreground, background, role, ratio, status, recommendation.
• Repairs: original pair, replacement pair, why it preserves the direction.
• Usage rules: where each pair can and cannot be used.
• Non-color cue suggestions for charts, status, warning, or selection.

If no concrete HEX values are provided, ask for values or first run xxd-palette-builder to produce a testable palette.