a11y-debugging

Analyze accessibility trees and run Lighthouse audits to identify web page issues.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/sertaoseracloud/sertao --skill a11y-debugging
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: a11y-debugging
Source: https://github.com/sertaoseracloud/sertao/tree/main/.agents/skills/a11y-debugging
Command: npx skills add https://github.com/sertaoseracloud/sertao --skill a11y-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables automated accessibility debugging and auditing to identify, understand, and remediate accessibility issues on web pages, by leveraging a combination of Lighthouse-based audits, accessibility tree analysis, and documented snippets.

Core Features & Use Cases

  • Automated accessibility audits (Lighthouse) to surface failures and remediation guidance.
  • Semantics and structure checks using the accessibility tree snapshot to verify heading order and landmarks.
  • Labels, focus management, tap targets, and color contrast checks with actionable recommendations.
  • Reusable snippet references for orphaned inputs and common accessibility pitfalls.

Quick Start

Run an automated accessibility audit on the target page and return a prioritized list of issues with remediation guidance.

Frequently Asked Questions about a11y-debugging

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

FAQPage Schema
How do I run an accessibility audit on a web page?

To run an accessibility audit, this Skill executes automated Lighthouse audits and analyzes the accessibility tree to identify issues. It returns a prioritized list of semantic, label, and color contrast failures with actionable remediation guidance.

What is the best way to check color contrast and ARIA issues?

Checking color contrast and ARIA issues is handled through automated auditing and accessibility tree analysis. The process detects failures in tap targets, focus management, and contrast ratios, providing specific recommendations to fix each violation.

Can I verify heading order and landmarks using an accessibility tree snapshot?

Yes, you can verify heading order and landmarks using an accessibility tree snapshot. The Skill analyzes the snapshot to check semantic structure, ensuring correct HTML landmarks and heading hierarchy for screen reader compatibility.

How do I find and fix orphaned inputs for keyboard navigation?

Finding orphaned inputs involves checking snippet references and the accessibility tree for missing label associations. The Skill identifies these keyboard navigation pitfalls and documents actionable fixes to ensure proper focus management and input labeling.

Does this tool require manual inspection for tap targets and focus management?

No manual inspection is required for tap targets and focus management. The Skill automates these checks alongside Lighthouse audits, directly returning actionable remediation steps to resolve any detected accessibility barriers.

Why does my Lighthouse accessibility audit still fail after fixing HTML structure?

A Lighthouse accessibility audit may still fail due to lingering color contrast violations, incorrect ARIA attributes, or poor tap target sizing. The Skill cross-references the accessibility tree to isolate these remaining structural and visual issues.