a11y-check

Audit mobile app screenshots and Maestro UI hierarchies for WCAG accessibility issues.

2|Updated Dec 19, 2025
One-click install
npx skills add https://github.com/slapglif/maestro-mcp --skill a11y-check
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: a11y-check
Source: https://github.com/slapglif/maestro-mcp/tree/main/skills/a11y-check
Command: npx skills add https://github.com/slapglif/maestro-mcp --skill a11y-check

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Accessibility Audit skill identifies and surfaces WCAG-related accessibility issues in mobile apps by analyzing UI screenshots and the element hierarchy.

Core Features & Use Cases

  • WCAG-focused evaluation: Detects color contrast violations, insufficient touch targets, missing labels, and readability barriers using Claude Vision and Maestro hierarchy data.
  • Screen-to-hierarchy analysis: Combines visual analysis with structure data to prioritize issues by impact on the user experience.
  • Use Case: Run audits across multiple screens of an app to generate a prioritized defect list for design and development teams.

Quick Start

Use the a11y-check skill to audit a mobile screen by providing a screenshot and the corresponding Maestro UI hierarchy. Example inputs: screenshot at path 'screen_001.png' and hierarchy at 'screen_001_hierarchy.json'.

Frequently Asked Questions about a11y-check

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

FAQPage Schema
How do I check my mobile UI for WCAG contrast and touch target issues?▼

To check mobile UI for WCAG contrast and touch target issues, you need to provide a screenshot image path and a Maestro UI hierarchy JSON file for structural analysis.

What is a Maestro UI hierarchy and how is it used for mobile accessibility audits?▼

A Maestro UI hierarchy is a JSON structure representing mobile app elements. Accessibility audits use it alongside Claude Vision to pinpoint missing labels and structural touch target violations.

Can I use Claude Vision to detect missing labels and readability barriers in mobile apps?▼

Yes, you can use Claude Vision to detect missing labels and readability barriers in mobile apps by combining visual screenshot analysis with Maestro UI hierarchy data.

What do I need to run a WCAG accessibility audit on a mobile app screen?▼

To run a WCAG accessibility audit on a mobile app screen, you need to provide two inputs: the file path to the screen screenshot and the corresponding Maestro UI hierarchy JSON.

How does screen-to-hierarchy analysis prioritize mobile accessibility defects?▼

Screen-to-hierarchy analysis prioritizes mobile accessibility defects by combining visual readability barriers from screenshots with structural UI data to evaluate impact on user experience.

Best way to generate a prioritized defect list for mobile UI accessibility issues?▼

The best way to generate a prioritized defect list for mobile UI accessibility issues is running audits that combine Claude Vision screenshot analysis with Maestro hierarchy data.