accessibility-audit

WCAG 2.1 accessibility audit covering contrast ratios, ARIA patterns, keyboard navigation, and screen reader compatibility.

Installation

Copy this skill directory into your Mayros skills folder:

cp -r skills/accessibility-audit ~/.mayros/skills/accessibility-audit

Or install via the Skills Hub:

mayros skill install @apilium/accessibility-audit

Usage

Activate the skill in your Mayros session and describe the component or page to audit:

Audit the login form for WCAG 2.1 AA compliance

The skill audits against WCAG 2.1 principles:

• Perceivable (1.x) -- alt text, contrast ratios, color usage, non-text contrast
• Operable (2.x) -- keyboard access, focus order, focus visibility, no keyboard traps
• Understandable (3.x) -- page language, labels, error identification, consistent behavior
• Robust (4.x) -- ARIA roles, names, values, valid markup

Contrast Checking

The skill validates contrast ratios against WCAG thresholds:

| Level | Normal Text | Large Text | |-------|------------|------------| | AA | 4.5:1 minimum | 3:1 minimum | | AAA | 7:1 minimum | 4.5:1 minimum |

Contrast ratio formula: (L1 + 0.05) / (L2 + 0.05) where L1 is the lighter relative luminance.

ARIA Validation

Common ARIA patterns checked:

• Modal dialogs: role="dialog" with aria-modal="true" and focus trapping
• Tabs: role="tablist" / role="tab" / role="tabpanel" with arrow key navigation
• Live regions: aria-live="polite" for status updates, aria-live="assertive" for alerts
• Form fields: associated labels via <label for> or aria-labelledby

Conformance Levels

The audit reports an overall conformance level:

• AAA -- no violations at any level
• AA -- no Level A or AA violations
• A -- no Level A violations
• none -- Level A violations present

Semantic Predicates

| Predicate | Description | |-----------|-------------| | a11y:violation_found | An accessibility violation was detected | | a11y:compliant | The target passes all criteria for the declared level (proof required) | | a11y:audit_context | Namespace-level audit history |

License

MIT