contrast-audit

Audit editor theme color contrast against WCAG 2.1 AA and APCA standards.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/awieczork/theme-framework --skill contrast-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: contrast-audit
Source: https://github.com/awieczork/theme-framework/tree/main/.github/skills/contrast-audit
Command: npx skills add https://github.com/awieczork/theme-framework --skill contrast-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires coloraide, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the critical need for accessible color contrast in digital interfaces by automatically auditing color combinations against established accessibility standards.

Core Features & Use Cases

  • Dual-Standard Auditing: Verifies color pairs against both WCAG 2.1 AA (legal compliance) and APCA (perceptual quality) standards.
  • Comprehensive Reporting: Generates detailed reports highlighting pass/fail status, quality gaps, and specific remediation advice.
  • Use Case: When developing a new editor theme, use this Skill to ensure all text and UI elements meet accessibility requirements before release, preventing user complaints and ensuring compliance.

Quick Start

Use the contrast-audit skill to check the color contrast for the attached theme file 'my-theme.json'.

Frequently Asked Questions about contrast-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit color contrast for WCAG compliance in an editor theme?

To audit color contrast for WCAG compliance, the Skill validates foreground and background color pairs from editor themes against WCAG 2.1 AA legal thresholds and generates structured pass or fail reports with remediation advice.

What is APCA and how does it check perceptual color contrast?

APCA is a perceptual contrast standard used to evaluate text legibility. The Skill performs a dual-check audit validating color pairs against both WCAG 2.1 AA legal compliance and APCA perceptual quality thresholds.

Does this color audit require the coloraide dependency for calculations?

Yes, the color audit requires the coloraide dependency to perform calculations and validate foreground and background color pairs against WCAG and APCA accessibility thresholds.

What's the best way to identify quality gaps in theme development color palettes?

The best way to identify quality gaps is using a dual-standard audit that flags color pairs failing APCA perceptual thresholds, producing structured reports that highlight specific areas requiring remediation before theme release.

How do I generate a structured pass/fail report for my theme's color combinations?

You generate a structured pass/fail report by providing your editor theme file for the Skill to classify foreground and background color pairs, validate them against WCAG and APCA standards, and output targeted remediation advice.