Aria Specialist

What it does

When your agent uses it

• Tasks that involve Accessibility

Example prompts

• “/aria-specialist”

Workflow steps

12 steps, taken from the first numbered list in SKILL.md.

1. 1Does every interactive element have an accessible name?
2. 2Are ARIA roles used only where native HTML cannot express the semantics?
3. 3Are ARIA states (aria-expanded, aria-selected, aria-checked) updated dynamically when state changes?
4. 4Do aria-controls and aria-labelledby point to valid, existing IDs?
5. 5Are live regions present and using the correct politeness level?
6. 6Is focus managed correctly (modals trap focus, dialogs return focus)?
7. 7Are decorative elements hidden from assistive technology?
8. 8Are elements with aria-label` reserved for major navigable content (not decorative sections, stats bars, or banners)?
9. 9Does the page have a reasonable number of landmarks? Canonical set for informational pages: banner + navigation(s) + main + contentinfo…
10. 10When a has both aria-label and a heading, does the aria-label text match the heading? (If yes, switch to aria-labelledby` pointing to the…
11. 11Are there elements nested inside parent sections that already provide heading-based navigation for the same content?
12. 12Is role="region" used on code blocks, install snippets, demo panels, or promotional banners? If so, remove it -- these are not navigable…

What it can do on your machine

Read from SKILL.md and the folder at commit decf6ba. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md (its code samples are html).

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Aria Specialist loads about 1.6k tokens when it runs, and up to ~4.7k if it reads all its reference files. Until then it costs about 22 tokens; SKILL.md has 661 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~22

When it runs · the whole SKILL.md, loaded when a task matches

~1.6k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~4.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Community-Access/accessibility-agents at commit decf6ba, republished under its MIT licence (© Community-Access). 661 words, ~1,566 tokens.

name

aria-specialist

description

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

license

MIT

disable-model-invocation

true

metadata.tier

specialist

metadata.domain

web

metadata.output

findings

metadata.effort

medium

metadata.title

ARIA Specialist

<!-- Button with icon -- hide the icon -->
<button>
  <svg aria-hidden="true">...</svg>
  Save
</button>

<!-- Icon-only button -- needs aria-label -->
<button aria-label="Close dialog">
  <svg aria-hidden="true">...</svg>
</button>

<!-- Decorative image -->
<img src="decoration.png" alt="" aria-hidden="true">

### [N]. [Brief one-line description]

- **Severity:** [critical | serious | moderate | minor]
- **WCAG:** [criterion number] [criterion name] (Level [A/AA/AAA])
- **Confidence:** [high | medium | low]
- **Impact:** [What a real user with a disability would experience - one sentence]
- **Location:** [file path:line, or CSS selector, or component name]

**Current code:**
[code block showing the problem]

**Recommended fix:**
[code block showing the corrected code in the detected framework syntax]

## ARIA Specialist Findings Summary
- **Issues found:** [count]
- **Critical:** [count] | **Serious:** [count] | **Moderate:** [count] | **Minor:** [count]
- **High confidence:** [count] | **Medium:** [count] | **Low:** [count]

© Community-Access, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in skills/aria-specialist of Community-Access/accessibility-agents.

• SKILL.md
• agents/openai.yaml
• examples/findings.json
• references/aria-you-must-use-correctly.md
• references/landmark-and-region-overuse.md

Open the folder on GitHubat commit decf6ba