Repository navigation
Web Component Specialist
github-actions[bot] edited this page Oct 29, 2026
·
3 revisions
Audits web components (custom elements, Shadow DOM) for accessibility. Covers ElementInternals API, cross-shadow ARIA delegation, slot-based composition, form-associated custom elements, and shadow DOM focus management.
- Audits
ElementInternalsusage for accessible name, role, and state on custom elements - Detects broken ARIA references across shadow DOM boundaries
- Reviews slot-based composition for correct accessible tree structure
- Validates form-associated custom elements for label association and form participation
- Checks shadow DOM focus management including
delegatesFocus - Supports Lit, Stencil, FAST, and vanilla custom elements
- Building or reviewing custom elements that need ARIA semantics
- Debugging ARIA references that do not work across shadow DOM boundaries
- Ensuring form-associated custom elements participate correctly in form validation
- Auditing focus behavior inside shadow roots (tab order, focus trapping, delegation)
- Reviewing slot projections to confirm they produce a correct accessibility tree
- Component detection - Identifies custom element definitions and their shadow DOM mode (open/closed)
-
ElementInternals audit - Checks whether components use
attachInternals()for role, name, and state -
ARIA delegation audit - Verifies cross-shadow ARIA references use
ARIAMixinorElementInternalsinstead of brokenidreferences - Slot audit - Reviews projected content for correct ordering in the accessibility tree
-
Form audit - Validates
formAssociated,formStateRestoreCallback, and label association -
Focus audit - Checks
delegatesFocus,tabindexhandling, and keyboard interaction within shadow roots
Each direction, with its agent and when.
| Direction | Agent | When |
|---|---|---|
| Receives from | accessibility-lead | When custom elements are detected during a web audit |
| Hands off to | accessibility-lead | When general web accessibility concerns are found outside the component |
| Hands off to | aria-specialist | When complex ARIA patterns in custom elements need deeper review |
| Hands off to | keyboard-navigator | When shadow DOM focus management needs detailed keyboard testing |
/web-component-specialist Audit this custom dropdown component for shadow DOM accessibility
/web-component-specialist Check if our Lit-based form controls use ElementInternals correctly
/web-component-specialist Review ARIA delegation in our design system's custom elements
- accessibility-lead - Coordinates full web accessibility audits
- aria-specialist - Deep ARIA pattern expertise for complex widget roles
- keyboard-navigator - Focus management and keyboard interaction auditing
- forms-specialist - Form accessibility, complementary for form-associated custom elements
- Agents Overview
- Accessibility Lead
- Web Accessibility Wizard
- Document Accessibility Wizard
- Markdown Assistant
- Developer Hub
- GitHub Hub