auditing-web-accessibility

Audits websites for WCAG accessibility violations using axe-core and generates severity-grouped HTML reports.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/celikgo/webmobai --skill auditing-web-accessibility-celikgo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: auditing-web-accessibility
Source: https://github.com/celikgo/webmobai/tree/main/.claude/skills/auditing-web-accessibility
Command: npx skills add https://github.com/celikgo/webmobai --skill auditing-web-accessibility-celikgo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually checking a website for accessibility barriers is slow and easy to get wrong, and teams often discover WCAG violations only after a complaint or legal notice. This Skill runs a real axe-core audit across your pages, groups findings by impact, and produces a structured report you can hand to developers. ## Core Features & Use Cases - Full axe-core WCAG audit: Runs the complete axe WCAG 2.x ruleset via @axe-core/playwright, including computed color contrast, ARIA validity, and landmark rules, with findings grouped as critical, serious, moderate, or minor. - Accessibility tree inspection: Dumps the real CDP accessibility tree (Chromium) to catch unnamed buttons, missing landmarks, and heading-order jumps the way a screen reader sees them. - Keyboard and modal spot checks: Samples Tab traversal for focus traps and re-audits opened modals and dialogs that hide issues on the host page. - Use Case: Before a release, ask for a WCAG audit of your signup flow; the Skill audits each page, flags three critical missing form labels shared across pages, and delivers an HTML report with the top fixes by leverage. ## Quick Start Run a WCAG accessibility audit on https://example.com/pricing and summarize the critical and serious issues.

Frequently Asked Questions about auditing-web-accessibility

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

FAQPage Schema
How do I run a WCAG accessibility audit on a website?▼

Provide the target URL and the Skill launches a browser, runs a full axe-core audit on each page, and groups violations by critical, serious, moderate, and minor impact. It finishes by generating an HTML report and summarizing the top fixes by leverage.

What accessibility issues does axe-core detect?▼

Axe-core detects missing image alt text, unlabeled form inputs, buttons without accessible names, invalid ARIA attributes, missing landmarks, computed color-contrast failures, and heading-order problems. Each violation includes its rule id, description, helpUrl, and affected nodes.

Can I audit pages behind a login for accessibility?▼

Yes, capture an authenticated session once with the authenticated-sessions skill, then launch the audit with a storage_state_path so every page is audited in the logged-in state. Authenticated surfaces like dashboards often carry different findings than public pages.

Does an automated a11y audit prove WCAG AA compliance?▼

No, automated tools cover only a subset of WCAG criteria and cannot fully test keyboard traps, focus order, or screen-reader announcement quality. Treat the audit as a fast first pass and pair it with manual VoiceOver or NVDA testing for compliance claims.

Why did my accessibility audit report almost no issues?▼

If axe-core fails to load, the tool silently falls back to about eight supplementary checks and the response looks identical. A suspiciously clean result on a complex, ARIA-rich page is worth re-running before concluding the page is accessible.

How do I get a 0-100 accessibility score instead of a violation list?▼

Use the Lighthouse audit skill, which returns Lighthouse's official Accessibility score for dashboards and tracking targets. This skill returns the itemized axe violations behind such a score, and the two outputs are not convertible.