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.