What it does
Uses Chrome DevTools MCP for accessibility (a11y) debugging and auditing based on web.dev guidelines
Skills ZICQ category:Agent Workflows a11y-debugging
Uses Chrome DevTools MCP for accessibility (a11y) debugging and auditing based on web.dev guidelines. Use when testing semantic HTML, ARIA labels, focus states, keyboard navigation, tap targets, and color contrast.
Official URL:skills.sh
Intro in this page language first. The official description stays in its original wording; we do not rewrite SKILL.md.
Uses Chrome DevTools MCP for accessibility (a11y) debugging and auditing based on web.dev guidelines
testing semantic HTML, ARIA labels, focus states, keyboard navigation, tap targets, and color contrast
Per Agent Skills progressive disclosure: name and description load at startup (~100 tokens); the full SKILL.md body loads when the skill activates; scripts/, references/, and assets/ load only as needed. This file's sections: Core Concepts; Workflow Patterns; 1. Automated Audit (Lighthouse); 2. Browser Issues & Audits; 3. Semantics & Structure; 4. Labels, Forms & Text Alternatives. It includes spec-recommended sections: step-by-step instructions.
File analysis: besides SKILL.md, the body references references/a11y-snippets.md. Those resources load on demand.
Core ConceptsWorkflow Patterns1. Automated Audit (Lighthouse)2. Browser Issues & Audits3. Semantics & Structure4. Labels, Forms & Text Alternatives5. Focus & Keyboard Navigation6. Tap Targets and Visuals7. Color Contrast8. Global Page ChecksTroubleshooting
Source category:skills.sh agent-skill
namea11y-debuggingdescriptionreferences/a11y-snippets.mdThese paths are extracted from the text. Check the upstream package to verify the files exist.
Invocation syntax and available tools depend on your Agent client. Client integration guide ↗
Choose the target agent and installation scope, keep referenced package files, then verify the skill appears in the client's catalog.
This skill references supporting files. Retrieve the complete directory from the source; copying SKILL.md alone may leave missing dependencies.
Copy these instructions to a compatible agent and confirm the target directory matches your client.
Install the agent skill "a11y-debugging" into my project. The full SKILL.md and official description are at https://zicq.com/en/skills/skl-011141ef0afbcb5e-A11y-Debugging.html Save it as .cursor/skills/a11y-debugging/SKILL.md or .claude/skills/a11y-debugging/SKILL.md and keep the frontmatter name and description exactly as-is. This skill also ships scripts/, references/, or assets/ — fetch the whole folder from https://github.com/chromedevtools/chrome-devtools-mcp instead of creating only a SKILL.md.
Requires Node.js and npx. First inspect the repository's skill list to confirm the name.
npx skills add 'https://github.com/chromedevtools/chrome-devtools-mcp' --list
npx skills add 'https://github.com/chromedevtools/chrome-devtools-mcp' --skill 'a11y-debugging'
The CLI lets you choose the agent interactively. The default scope is the project; use -g for user scope. Confirm package availability with the discovery command, then use npx skills list to inspect installed skills.
Page Targeting: Page-scoped tools (take_snapshot, list_console_messages, evaluate_script, press_key, take_screenshot, lighthouse_audit, etc.) require a pageId parameter. Retrieve available page IDs using list_pages or from new_page.
Accessibility Tree vs DOM: Visually hiding an element (e.g., CSS opacity: 0) behaves differently for screen readers than display: none or aria-hidden="true". The take_snapshot tool returns the accessibility tree of the page, which represents what assistive technologies "see", making it the most reliable source of truth for semantic structure.
Reading web.dev documentation: If you need to research specific accessibility guidelines (like https://web.dev/articles/accessible-tap-targets), you can append .md.txt to the URL (e.g., https://web.dev/articles/accessible-tap-targets.md.txt) to fetch the clean, raw markdown version. This is much easier to read!
Start by running a Lighthouse accessibility audit to get a comprehensive baseline. This tool provides a high-level score and lists specific failing elements with remediation advice.
mode to "navigation" to refresh the page and capture load issues.outputDirPath (e.g., /tmp/lh-report) to save the full JSON report.scores (0-1 scale). A score < 1 indicates violations.audits.failed count.jq or a Node.js one-liner to filter for failures:
# Extract failing audits with their details
node -e "const r=require('./report.json'); Object.values(r.audits).filter(a=>a.score!==null && a.score<1).forEach(a=>console.log(JSON.stringify({id:a.id, title:a.title, items:a.details?.items})))"
selector and snippet of failing elements without loading the full report into context.Chrome automatically checks for common accessibility problems. Use list_console_messages to check for these native audits:
types: ["issue"]includePreservedMessages: true (to catch issues that occurred during page load)This often reveals missing labels, invalid ARIA attributes, and other critical errors without manual investigation.
The accessibility tree exposes the heading hierarchy and semantic landmarks.
take_snapshot to capture the accessibility tree.h1, h2, h3, etc.) are logical and do not skip levels. The snapshot will include heading roles.take_screenshot to inspect the visual layout and compare it against the snapshot structure to catch CSS floats or absolute positioning that jumbles the logical flow.take_snapshot output."" if it only contains an icon).evaluate_script with the "Find Orphaned Form Inputs" snippet found in references/a11y-snippets.md.alt text.Testing "keyboard traps" and proper focus management without visual feedback relies on tracking the focused element.
press_key tool with "Tab" or "Shift+Tab" to move focus.take_snapshot to capture the updated accessibility tree.According to web.dev, tap targets should be at least 48x48 pixels with sufficient spacing. Since the accessibility tree doesn't show sizes, use evaluate_script with the "Measure Tap Target Size" snippet found in references/a11y-snippets.md.
Pass the element's uid from the snapshot as an argument to evaluate_script.
To verify color contrast ratios, start by checking for native accessibility issues:
list_console_messages with types: ["issue"].If native audits do not report issues (which may happen in some headless environments) or if you need to check a specific element manually, use evaluate_script with the "Check Color Contrast" snippet found in references/a11y-snippets.md.
Verify document-level accessibility settings often missed in component testing using the "Global Page Checks" snippet found in references/a11y-snippets.md.
If standard a11y queries fail or the evaluate_script snippets return unexpected results:
take_screenshot to capture the element. While models cannot measure exact contrast ratios from images, they can visually assess legibility and identify obvious issues.Agent Workflows
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that exte…
Agent Workflows
Use the ClawdHub CLI to search, install, update, and publish agent skills from clawdhub.com. Use when you need to fetch new skills on the fl…
Agent Workflows
Orchestrate multi-agent teams with defined roles, task lifecycles, handoff protocols, and review workflows. Use when: (1) Setting up a team …
Agent Workflows
Spec-first, TDD, subagent-driven software development workflow. Use when: (1) building any new feature or app — triggers brainstorm → plan →…