antislop-human

Validates UI accessibility for contrast, keyboard navigation, focus states, and mobile zoom against WCAG criteria.

Updated Dec 17, 2025
One-click install
npx skills add https://github.com/faidzagustiawan/portofolio --skill antislop-human-faidzagustiawan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: antislop-human
Source: https://github.com/faidzagustiawan/portofolio/tree/main/agent/skills/antislop-human
Command: npx skills add https://github.com/faidzagustiawan/portofolio --skill antislop-human-faidzagustiawan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI-generated interfaces frequently ship with accessibility defects: grey-on-grey text that fails WCAG contrast ratios, removed focus outlines, hover-only menus, color-only status feedback, and forms hidden behind mobile keyboards. This Skill gives coding agents concrete rules and a deterministic contrast checker so these exclusions are caught before delivery instead of after users complain. ## Core Features & Use Cases - Contrast Verification: A Python script, the WCAG 2.x luminance formula, and a precomputed reference table for checking any text/background pairing against the 4.5:1 and 3:1 thresholds, including text over images and gradients. - Keyboard and Focus Rules: Tell/Why/Fix patterns for removed focus outlines, mouse-only interactions, broken tab order, and weak focus indicators, each tied to governing core rules (R-25, R-26, R-32, R-34). - State and Mobile Checks: Requirements for perceivable empty/loading/error states, 200% text zoom without clipping, and keeping focused inputs visible above the on-screen keyboard. - Use Case: While building a settings page, an agent pairs #777777 labels on white, runs python3 contrast-check.py "#FFFFFF" "#777777", sees normal text FAIL at 4.48:1, and darkens the label before shipping. ## Quick Start Ask the agent to audit your UI's colors, focus styles, and form states using the antislop human accessibility checklist and contrast checker.

Frequently Asked Questions about antislop-human

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

FAQPage Schema
How do I check WCAG contrast ratio between two hex colors?▼

Run the bundled script with two hex colors: python3 contrast-check.py "#FFFFFF" "#777777". It prints the ratio and PASS/FAIL verdicts for normal text (4.5:1) and large text (3:1), exiting nonzero when either fails.

What contrast ratio does WCAG AA require for text?▼

WCAG AA requires 4.5:1 for normal text and 3:1 for large text at 18px or larger. Non-text UI such as button borders, icons, and focus indicators must meet 3:1 against adjacent colors per WCAG 1.4.11.

Can I use the contrast checker as an MCP tool?▼

Yes, contrast-mcp.py is a minimal MCP stdio server exposing a check_contrast tool that takes foreground and background hex strings. It returns the ratio plus pass/fail booleans for both text size thresholds as JSON.

Why does grey text on white backgrounds fail accessibility checks?▼

The eye overestimates contrast on grey pairs, so combinations like #777777 on white (4.48:1) fall just under the 4.5:1 normal-text threshold. Always compute the ratio with the formula or script instead of judging by appearance.

Does the contrast checker work without the Python script?▼

Yes, the SKILL.md documents the full WCAG 2.x luminance formula and a precomputed reference table for common pairings. The script is a convenience; the formula and table are complete on their own.