Accessibility Scanner CLI Skill

Run Axe-core accessibility scans and keyboard audits via an interactive CLI.

56|14|Updated Jan 26, 2025
One-click install
npx skills add https://github.com/JustasMonkev/mcp-accessibility-scanner --skill accessibility-scanner-cli-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Accessibility Scanner CLI Skill
Source: https://github.com/JustasMonkev/mcp-accessibility-scanner/tree/main
Command: npx skills add https://github.com/JustasMonkev/mcp-accessibility-scanner --skill accessibility-scanner-cli-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual, error-prone work of running browser-based accessibility checks by letting you drive navigation, scanning, and keyboard audits through a single interactive command loop.

Core Features & Use Cases

  • Interactive REPL execution: Use npx mcp-accessibility-scanner interactive to call accessibility and browser automation tools step-by-step.
  • WCAG scans with Axe-core: Run scan_page for focused page checks, and use audit_site or scan_page_matrix for broader testing.
  • Keyboard accessibility auditing: Use audit_keyboard to validate tab order, focus visibility, focus traps, and optional issue screenshots.

Example use cases

  • Audit a logged-in flow: navigate to a page, take a snapshot, click through UI controls, then run scan_page and audit_keyboard before recording findings.
  • Validate responsive accessibility: run scan_page_matrix to compare violations across mobile/desktop/contrast/reduced-motion/zoom variants.

Quick Start

Run npx mcp-accessibility-scanner interactive and then type browser_navigate {"url":"https://example.com"} to start auditing a site interactively.

Frequently Asked Questions about Accessibility Scanner CLI Skill

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

FAQPage Schema
How do I run WCAG accessibility audits from the command line?

Run WCAG accessibility audits by executing `npx mcp-accessibility-scanner interactive` to launch a REPL, then use commands like `browser_navigate` and `scan_page` to perform Axe-core checks on your target pages.

Can I automate keyboard focus auditing for web pages?

You can automate keyboard focus auditing by using the `audit_keyboard` command within the interactive CLI, which validates tab order, focus visibility, and focus traps, and optionally captures screenshots of identified issues.

What is the best way to compare accessibility violations across responsive variants?

Comparing accessibility violations across responsive variants is best handled by the `scan_page_matrix` command, which checks pages against mobile, desktop, contrast, reduced-motion, and zoom contexts.

Do I need prior browser automation setup to scan a site for WCAG compliance?

No prior setup is needed beyond Node.js, because the Skill routes browser automation and Axe-core scans through the `npx mcp-accessibility-scanner interactive` CLI, allowing you to navigate and audit sites immediately.

How does the scanner handle multi-page site accessibility testing?

Multi-page site accessibility testing is handled via the `audit_site` command, which applies the Axe-core scanning workflow across multiple pages and routes browser automation through the interactive CLI loop.

Where does the CLI accessibility scanner save audit results?

The CLI accessibility scanner saves audit results by writing structured JSON reports to the configured output directory, ensuring your WCAG violation findings and keyboard audit data are persisted for review.