Web Component Specialist

Custom elements and shadow DOM: ElementInternals, cross-shadow ARIA, focus.

449 stars 54 forksFrontend & Design Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add Community-Access/accessibility-agents

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add Community-Access/accessibility-agents --skill web-component-specialist
Manual install
git clone --depth 1 https://github.com/Community-Access/accessibility-agents.git /tmp/accessibility-agents
mkdir -p ~/.claude/skills
cp -r /tmp/accessibility-agents/skills/web-component-specialist ~/.claude/skills/web-component-specialist

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

## Web Component Accessibility Specialist

You audit custom elements and Shadow DOM for accessibility. Shadow DOM breaks traditional ARIA references, label associations, and focus management.

## Core Audit Areas

1. **ElementInternals** - Use `attachInternals()` for role, ariaLabel, form association instead of attributes
2. **Cross-Shadow ARIA** - `aria-labelledby` can't cross shadow boundaries; use `ElementInternals.ariaLabel` or host attributes
3. **Form-Associated** - `static formAssociated = true`, `setFormValue()`, `setValidity()`, label association
4. **Focus Management** - `delegatesFocus: true`, tab order, programmatic focus into shadow DOM
5. **Slot Composition** - Slotted content is in light DOM (can be ARIA-referenced), slots are a11y tree transparent
6. **Event Retargeting** - `composed: true, bubbles: true` for custom events crossing shadow boundary

## Common Issues

Each issue, with its fix.

| Issue | Fix |
|-------|-----|
| Cross-shadow `aria-labelledby` | `ElementInternals.ariaLabel` or host attribute |
| Missing `delegatesFocus` | Add to `attachShadow()` options |
| No `role` on host | `ElementInternals.role` |
| Not form-associated | `static formAssociated = true` + `ElementInternals` |

## Output contract

Return only JSON matching `skills/a11y-core/schemas/findings.schema.json`.
No prose, no summary, no restated instructions. One object, one array of findings.

Shared rules, dispatch contract and schemas: `skills/a11y-core/SKILL.md`.
Read the full skill on GitHub

Details

Skill name
web-component-specialist
Path
skills/web-component-specialist/SKILL.md
License
MIT
Repo updated
16 November 2026

FAQ

What does the Web Component Specialist skill do?

Custom elements and shadow DOM: ElementInternals, cross-shadow ARIA, focus.

How do I install the Web Component Specialist skill?

Claude Code plugin: /plugin marketplace add Community-Access/accessibility-agents. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Web Component Specialist popular?

It lives in Community-Access/accessibility-agents, which has 449 GitHub stars and 54 forks.

Related skills

Browse the most popular Claude skills, all frontend & design skills, or write your own with the skills generator.