aria-roles

aria-roles is a skill for Claude Code, Codex from thedaviddias/Front-End-Checklist. It costs 49 tokens per session (418 once invoked), scanned A, original, MIT.

A review guide for checking that web interfaces use valid ARIA role names. ARIA roles describe the purpose of custom controls to assistive technology.

In plain words
What is it for?
Use it when reviewing rendered HTML, interactive components, or design-system patterns that use ARIA roles.
Why use it?
It catches invalid role values that can prevent browsers and screen readers from understanding an interface correctly.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it when reviewing rendered HTML, interactive components, or design-system patterns that use ARIA roles.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/thedaviddias/front-end-checklist/aria-roles
About the project

Front-End Checklist is a collection of front-end web development rules organized as a practical review and quality workflow for people and AI agents. Developers use it to audit projects and pull requests, check implementation details, and find guidance for remediation and verification. The catalogue entries provide skills, instructions, MCP tools, and a plugin for using the checklist in agent workflows.

thedaviddias/Front-End-Checklist · 74,577 stars · on GitHub · frontendchecklist.io

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add thedaviddias/Front-End-Checklist --skill aria-roles
Clone the repo
git clone --depth 1 https://github.com/thedaviddias/Front-End-Checklist

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for aria-roles

README.md
[![agentmods](https://agentmods.dev/badge/skills/thedaviddias/front-end-checklist/aria-roles/github.svg)](https://agentmods.dev/skills/thedaviddias/front-end-checklist/aria-roles)
Your own site
<a href="https://agentmods.dev/skills/thedaviddias/front-end-checklist/aria-roles"><img src="https://agentmods.dev/badge/skills/thedaviddias/front-end-checklist/aria-roles/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for aria-roles

Your own site · 80×15
<a href="https://agentmods.dev/skills/thedaviddias/front-end-checklist/aria-roles"><img src="https://agentmods.dev/badge/skills/thedaviddias/front-end-checklist/aria-roles.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 49 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 418 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00049 $0.00418
Opus 5.5 $0.00020 $0.00167
Sonnet 5.5 $0.00010 $0.00084
Haiku 4.5 $0.00005 $0.00042

Measured 23d ago against content hash 00bd6fdc9209, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

aria-roles scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 23d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/aria-roles/SKILL.md · 46 lines

What it actually says

Use valid ARIA role values

Invalid or misspelled ARIA roles are ignored by browsers and assistive technologies, rendering the intended accessibility features useless and potentially confusing users.

Quick Reference

  • Use only standard ARIA roles defined in the W3C specification
  • Avoid typos or non-existent roles (e.g., use checkbox, not check-box)
  • Ensure roles are applied to appropriate HTML elements
  • Prefer native HTML controls over custom ARIA widgets whenever possible

Check

Search for any role attributes that use non-standard or misspelled ARIA role values.

Fix

Replace invalid ARIA roles with the correct, standard values from the WAI-ARIA specification. When a native <button>, <input>, <select>, or other semantic element can replace the custom widget, prefer that change over adding more ARIA.

Explain

Explain why using standardized ARIA roles is critical for ensuring that assistive technologies can interpret and announce elements correctly, and why native HTML controls are usually more reliable than recreating them with ARIA.

Code Review

Review the rendered markup and interactive states that affect Use valid ARIA role values. Flag exact elements, roles, labels, focus behavior, or keyboard interactions that violate the rule, and note how to verify the fix with browser accessibility tooling or assistive tech.


For full implementation details, code examples, and framework-specific guidance, see references/rule.md.

Rule page: https://frontendchecklist.io/rules/accessibility/aria-roles

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 23d ago Changed 00bd6fdc9209
  2. 1mo ago First seen · 46 lines · 49 tokens per session scan A 5ce3752df9be

Subscribe to this mod's changes

aria-roles is a skill published in the GitHub repository thedaviddias/Front-End-Checklist (74,577 stars, last pushed 21d ago), licensed MIT. It adds 49 tokens to every session and 418 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

scalar-design-system

Scalar's design system — design tokens, theming (@scalar/themes), CSS variables, and the @scalar/components library. Use when designing or implementing Scalar UI, especially with Paper (code-to-design / design-to-code), so output matches real Scalar tokens, colors, typography, spacing, and components instead of…

scalar/scalar · 68 tokens

citation-verification

This skill provides reference guidance for citation verification in academic writing. Use when the user asks about "citation verification best practices", "how to verify references", "preventing fake citations", or needs guidance on citation accuracy. This skill supports ml-paper-writing by providing detailed…

Galaxy-Dawn/claude-scholar · 63 tokens

stopovers

Per-program stopover rules for award redemptions. Which programs allow free stopovers, how many, how long, and which don't. Covers Icelandair, Aeroplan, Alaska, Flying Blue, Singapore, Cathay, JAL, and the negative space (BA, AA, Delta).

borski/travel-hacking-toolkit · 62 tokens

flight-search-strategy

Canonical multi-source flight search strategy. Source priority (Duffel, Ignav, Google Flights, Skiplagged, Kiwi, Seats.aero, Southwest), parallel workflow, market selection for international price arbitrage.

borski/travel-hacking-toolkit · 48 tokens

alliances

Airline alliance membership (Star Alliance, oneworld, SkyTeam) and cross-alliance booking relationships. Maps which loyalty programs book which airlines, including bilateral partnerships outside alliances.

borski/travel-hacking-toolkit · 39 tokens

lingtai-tui-anatomy

Source-navigation guide for the LingTai Go monorepo that ships lingtai-tui and lingtai-portal. Read this for TUI/Portal structure, runtime-boundary evidence, exact Go ownership, or when updating an ANATOMY.md. The repository-root ANATOMY.md is normative; this skill routes into that graph without duplicating it. Kernel…

Lingtai-AI/lingtai · 100 tokens