apca-contrast

Calculate APCA lightness contrast for text-on-surface accessibility.

1|Updated May 15, 2026
One-click install
npx skills add https://github.com/thrillmade/agent-skills --skill apca-contrast
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: apca-contrast
Source: https://github.com/thrillmade/agent-skills/tree/main/skills/apca-contrast
Command: npx skills add https://github.com/thrillmade/agent-skills --skill apca-contrast

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps in selecting appropriate text-on-surface contrast for accessibility, auditing contrast budgets, and generating colors against specific contrast targets, ensuring compliance with APCA and WCAG 2.2 AA standards.

Core Features & Use Cases

  • APCA Contrast Calculation: Calculates Lc (lightness contrast) on a 0–105+ scale for text-on-surface contrast.
  • Palette Generation: Generates palettes targeting specific Lc bands for consistent readability.
  • Code Review: Flags contrast picks using WCAG 2.x as the primary model instead of APCA.
  • Use Case: When designing a user interface, use this Skill to check the contrast of text elements against their background to ensure accessibility.

Quick Start

Generate a color with Lc 75 contrast against a white background using the apca-contrast skill.

Frequently Asked Questions about apca-contrast

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

FAQPage Schema
How do I calculate text-on-surface contrast using APCA?

APCA contrast is calculated by computing lightness contrast (Lc) on a 0–105+ scale for text-on-surface pairs, providing an accurate perceptual contrast measurement for UI design and accessibility audits.

What is the difference between APCA Lc values and WCAG contrast ratios?

APCA Lc values differ from WCAG contrast ratios by modeling perceptual lightness contrast specifically for text-on-surface, whereas WCAG uses a simpler ratio. This Skill flags WCAG-only picks to encourage APCA compliance for better readability.

How do I generate a color palette that meets specific APCA contrast targets?

You can generate a color palette targeting specific Lc bands by providing a background color and desired contrast level. This ensures consistent readability across UI elements while maintaining APCA and WCAG 2.2 AA compliance.

Do I need the apcach library to calculate APCA contrast?

Yes, the apcach library is required as a dependency to perform inverse composition and calculate APCA lightness contrast, enabling accurate Lc value generation and palette creation for accessibility auditing.

When should I use APCA over standard WCAG contrast models for accessibility?

Use APCA over standard WCAG contrast models when designing user interfaces, as it provides a more perceptually accurate lightness contrast calculation for text-on-surface, ensuring optimal readability and WCAG 2.2 AA compliance.