Accessibility UX

Purpose

Provide structured guidance for building, auditing, and fixing accessible web interfaces. This domain now also supports production-grade reporting and assistive-technology edge-case investigations required for real release governance.

Domain Coverage

This package represents the accessibility and UX standards domain. It covers multiple interconnected capabilities: fixing specific accessibility violations, auditing against WCAG criteria, testing with screen readers, validating visual output, optimizing motion performance, ensuring correct page metadata, producing audit reporting outputs, and triaging AT/input edge cases.

How to Use

1. Always begin with self-diagnostic. Start with a quick package integrity check, then validate only the activated working set. The self-diagnostic rules are defined in self-diagnostic-protocol.md.
2. Identify the primary mini-skill that best matches the task.
3. Check the Multi-Skill Activation Guide below to load adjacent mini-skills that commonly co-occur with the primary task.
4. Open the corresponding reference file under references/skills/.
5. Open the corresponding examples file under examples/skills/ if concrete code is needed.
6. Use resources/skill-catalog.md for the full index.
7. Use resources/routing-guide.md when a task spans multiple mini-skills.
8. Use resources/asset-link-index.md to find every auxiliary folder and file.

Multi-Skill Activation Guide

Do not treat mini-skills as isolated when the task spans multiple concerns. For all non-trivial tasks, apply the universal composition rule in composition-protocol.md.

Common combinations:

• Full accessibility audit: wcag-audit-patterns (primary) + fixing-accessibility + screen-reader-testing + ui-visual-validator
• Fixing UI components: fixing-accessibility (primary) + wcag-audit-patterns + screen-reader-testing
• Screen reader compatibility: screen-reader-testing (primary) + fixing-accessibility + wcag-audit-patterns
• Visual regression review: ui-visual-validator (primary) + fixing-accessibility + wcag-audit-patterns
• Animation performance: fixing-motion-performance (primary) + fixing-accessibility + ui-visual-validator
• SEO and metadata: fixing-metadata (primary) + ui-visual-validator + fixing-accessibility
• Accessibility audit report: wcag-audit-reporting (primary) + wcag-audit-patterns + screen-reader-testing + ui-visual-validator
• Assistive-tech edge-case investigation: assistive-tech-edge-cases (primary) + screen-reader-testing + fixing-accessibility + ui-visual-validator
• Remediation program: fixing-accessibility (primary) + wcag-audit-reporting + wcag-audit-patterns + screen-reader-testing
• Motion accessibility risk: fixing-motion-performance (primary) + assistive-tech-edge-cases + fixing-accessibility

Package Structure

• SKILL.md — lightweight router and high-level index
• composition-protocol.md — universal rules for selecting and combining mini-skills
• self-diagnostic-protocol.md — self-diagnostic rules for this domain package
• resources/skill-catalog.md — full catalog of extracted mini-skills
• resources/routing-guide.md — navigation and composition rules
• resources/asset-link-index.md — complete link map for every auxiliary folder and file
• resources/manifest.json — machine-readable package manifest
• shared-rules/STYLE-GUARDRAILS.md — package-wide output guardrails used across mini-skills
• shared-rules/ANTI-PATTERNS.md — package-wide mistakes and rejection checks used across mini-skills
• references/skills/*.md — full extracted guidance per mini-skill
• examples/skills/*.md — extracted code snippets and usage samples

Mini-Skills Index

fixing-accessibility

• Summary: Review and fix UI accessibility violations with targeted, minimal patches covering ARIA attributes, semantic HTML, keyboard access, focus management, and form error linking.
• Open reference: references/skills/fixing-accessibility.md
• Open examples: examples/skills/fixing-accessibility.md

fixing-metadata

• Summary: Audit and fix page metadata including titles, descriptions, canonical URLs, Open Graph tags, Twitter cards, favicons, structured data, and locale settings.
• Open reference: references/skills/fixing-metadata.md
• Open examples: examples/skills/fixing-metadata.md

fixing-motion-performance

• Summary: Diagnose and fix animation performance issues including layout thrashing, composite layer promotion, FLIP patterns, scroll-linked motion, and reduced-motion preferences.
• Open reference: references/skills/fixing-motion-performance.md
• Open examples: examples/skills/fixing-motion-performance.md

screen-reader-testing

• Summary: Test web applications with screen readers (VoiceOver, NVDA, JAWS, TalkBack) covering navigation, forms, dynamic content, modals, live regions, and tab interfaces.
• Open reference: references/skills/screen-reader-testing.md
• Open examples: examples/skills/screen-reader-testing.md

ui-visual-validator

• Summary: Verify UI modifications, design system compliance, and accessibility implementation through systematic visual analysis with evidence-based assessment methodology.
• Open reference: references/skills/ui-visual-validator.md
• Open examples: examples/skills/ui-visual-validator.md

wcag-audit-patterns

• Summary: Audit web content against WCAG 2.2 guidelines across all four POUR principles with automated tooling, manual checks, and actionable remediation strategies.
• Open reference: references/skills/wcag-audit-patterns.md
• Open examples: examples/skills/wcag-audit-patterns.md

wcag-audit-reporting

• Summary: Guide production-grade accessibility audit reporting, remediation governance, evidence packaging, owner assignment, retesting, and stakeholder-ready summaries.
• Open reference: references/skills/wcag-audit-reporting.md
• Open examples: examples/skills/wcag-audit-reporting.md

assistive-tech-edge-cases

• Summary: Guide detection and remediation of issues that appear only under AT combinations, alternate input modes, or accessibility setting stress conditions.
• Open reference: references/skills/assistive-tech-edge-cases.md
• Open examples: examples/skills/assistive-tech-edge-cases.md

Validation

• Keep detailed implementation guidance outside the main SKILL.md.
• Prefer adding or updating auxiliary files rather than re-expanding the router.
• Preserve skill-specific constraints, examples, and workflow details in the extracted files.

Output Requirements

• Keep the main file concise and navigational.
• Store deep guidance in auxiliary files.
• Use descriptive, stable file names for extracted mini-skills.