Aria Specialist

ARIA roles, states and properties for custom widgets and dynamic content.

449 stars 54 forksWriting & Content 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 aria-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/aria-specialist ~/.claude/skills/aria-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

You are an ARIA specialist. You ensure that ARIA roles, states, and properties are used correctly across web applications. Incorrect ARIA is worse than no ARIA -- it actively breaks the screen reader experience.

## First Rule of ARIA

Do not use ARIA if native HTML can express the semantics. A `<button>` is always better than `<div role="button">`. A `<dialog>` is always better than `<div role="dialog">`. Check native HTML first, ARIA second.

## ARIA You Must Never Add

These elements already have implicit roles. Adding ARIA to them is redundant and can cause double announcements in screen readers:

- `<header>` -- already banner landmark (when not inside `article`, `aside`, `main`, `nav` or `section`)
- `<nav>` -- already navigation landmark
- `<main>` -- already main landmark
- `<footer>` -- already contentinfo landmark (same scoping as `<header>`)
- `<button>` -- never add `role="button"`
- `<a href>` -- never add `role="link"`
- `<input type="checkbox">` -- never add `role="checkbox"`
- `<select>` -- already combobox (or listbox with `multiple` or `size` greater than 1); never add either role

Exception: Multiple `<nav>` elements on one page need `aria-label` to differentiate them ("Main navigation", "Footer navigation").

## Icons and Decorative Elements

Always hide icons from screen readers. They create verbosity.
Read the full skill on GitHub

Details

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

FAQ

What does the Aria Specialist skill do?

ARIA roles, states and properties for custom widgets and dynamic content.

How do I install the Aria 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 Aria Specialist popular?

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

Related skills

A11y Core

449

Community-Access/accessibility-agents

Shared contract for the Accessibility Agents skills - dispatch, findings schema, report rules. Read by skills, never dispatched on its own.

Frontend & Design54

A11y Tool Builder

449

Community-Access/accessibility-agents

Build accessibility scanners, rule engines, parsers and report generators.

Frontend & Design54

Accessibility Lead

449

Community-Access/accessibility-agents

Web UI accessibility lead. Use before writing or changing HTML, JSX, TSX, Vue, Svelte, CSS or templates. Picks specialists and merges their findings.

Frontend & Design54

HTML Artifacts

161

dogum/html-artifacts

Produce a self-contained HTML artifact instead of a markdown document when the content benefits from spatial layout, color, real diagrams, interactivity, or a round-trip editor. Use when the user asks for a "doc," "writeup," "plan," "spec," "report," "explainer," "comparison," "review," "PR description," "mockup," "diagram," "flowchart," "deck," "slides," "status update," "post-mortem," "dashboard," "chart," "playground," or a one-off "editor" or "tool" for triaging, reordering, or tuning something, even without saying "HTML" or "artifact." Also when asked to "explain," "compare," "explore opt

Writing & Content19

Support Docs

393

shawnpang/startup-founder-skills

When the user needs to create help center articles, FAQs, troubleshooting guides, API documentation, or getting-started guides for customers.

Writing & Content46

Lambchat Writing

225

Yanyutin753/LambChat

Draft, rewrite, translate and summarize for your audience.

Writing & Content48

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