Accessibility Compliance
A practical WCAG 2.2 AA toolkit for news and academic sites: alt text rules, accessible charts, keyboard patterns, and automated axe-core audits.
Dev & CodingIntermediate★ 403⑂ 66AI score 9/10Last updated: Sep 25, 2026
What it does
- WCAG 2.2 AA checklists organized around POUR, plus the 2.2-specific criteria that matter most for publishers (24×24px target size, focus not obscured by sticky headers, accessible authentication, no redundant entry).
- Alt text guidance with a decision tree and good/bad examples for news photos, headshots, chart images, and AI-generated illustrations (including required provenance disclosure in alt text).
- Accessible data visualization: a copy-paste
<figure>+ data-table HTML pattern, Paul Tol colorblind-safe palettes (categorical, sequential, diverging), and a Python WCAG contrast-ratio function. - Keyboard, motion, and form patterns: skip links, modal focus-trap handling,
prefers-reduced-motiongating for CSS and JS, andaria-describedby/aria-invaliderror messaging. - Testing workflow: version-pinned axe-core injected locally via Playwright, a violation formatter, and a manual checklist for screen readers, zoom, and grayscale.
- Legal summary for US (Section 508, ADA Title II/III, HHS 504) and EU (EAA, EN 301 549) with compliance deadlines.
Who it's for
- Frontend developers building newsroom, academic, or public-sector sites
- Digital editors responsible for image alt text and captions
- Data journalists shipping interactive charts
- QA engineers or web leads asked to produce an accessibility audit
Example uses
- "Audit our article template against WCAG 2.2 AA" → checklist walkthrough plus the axe-core/Playwright audit script with violations grouped by impact.
- "Write alt text for this courthouse protest photo" → a concise WHO/WHAT/WHERE description under 125 characters that doesn't repeat the caption.
- "Make our unemployment line chart screen-reader friendly" → figure/figcaption markup with aria-describedby and an expandable data table.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/jamditis/claude-skills-journalism/HEAD/dev-toolkit/skills/accessibility-compliance/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the dev-toolkit/skills/accessibility-compliance folder from the GitHub repo jamditis/claude-skills-journalism into my ~/.claude/skills/accessibility-compliance/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/jamditis/claude-skills-journalism.git && mkdir -p ~/.claude/skills && cp -r claude-skills-journalism/dev-toolkit/skills/accessibility-compliance ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal (Terminal on macOS/Linux, PowerShell on Windows).
- Clone the repository:
git clone https://github.com/jamditis/claude-skills-journalism.git - Create the skills directory if needed:
mkdir -p ~/.claude/skills - Copy just this skill:
cp -r claude-skills-journalism/dev-toolkit/skills/accessibility-compliance ~/.claude/skills/ - Restart Claude Code and confirm it loaded with
/skills. - For the automated audit, also run
npm install --save-dev --save-exact axe-core@4.12.1in your project andpip install playwright && playwright install chromium. - Trigger it with a request like "check this page for accessibility issues" or "write alt text for this image".
View source on GitHub ↗License: MIT