aria-roles SKILL.md skillA

aria-roles from thedaviddias/front-end-checklist is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add thedaviddias/front-end-checklist/aria-roles@git:20260529.7c05904

Pins git:20260529.7c05904 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
thedaviddias/front-end-checklist
Path
skills/aria-roles/SKILL.md
Versions recorded
1
Latest version
git:20260529.7c05904, committed May 29, 2026
Size
2,063 bytes
Repository stars
74,516
License
MIT

Use when reviewing rendered HTML, interactive components, or design-system patterns related to Use valid ARIA role values. Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output where relevant.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file 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
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add thedaviddias/front-end-checklist/aria-roles@sha256:5ce3752df9be0987

The line at the top of this page pins the label git:20260529.7c05904, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_obtl2drnyni4knms.svg)](https://markdownregistry.com/a/art_obtl2drnyni4knms)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on May 29, 2026.

versioncommittedcommitsizeaudit
git:20260529.7c05904 latest2026-05-29 7c05904 2,063 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2063 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

thedaviddias/front-end-checklist · 74,516 stars · license MIT · pushed 2026-10-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_obtl2drnyni4knms
GET https://markdownregistry.com/api/v1/resolve?ref=thedaviddias/front-end-checklist/aria-roles
GET https://markdownregistry.com/api/v1/blob/5ce3752df9be0987d2ec245f2318b95914fdada3a40274f02bd1b88c2ebfe8c0

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from thedaviddias/front-end-checklist

AGENTS.md AGENTS.md file
thedaviddias/front-end-checklist · AGENTS.md
git:20260930.d3ad6b7 · audit A · 74,516 stars
CLAUDE.md CLAUDE.md file
thedaviddias/front-end-checklist · CLAUDE.md
git:20260602.065968e · audit A · 74,516 stars
frontendchecklist SKILL.md skill
thedaviddias/front-end-checklist · packages/cli/SKILL.md · Review frontend code and live pages against the Front-End Checklist (380+ rules for accessibility, performance, SEO…
git:20261001.9b4f0d0 · audit A · 74,516 stars
frontend-checklist-global SKILL.md skill
thedaviddias/front-end-checklist · plugins/front-end-checklist/skills/frontend-checklist-global/SKILL.md · Use when auditing or improving any frontend codebase against the full Front-End Checklist rule corpus through one entry…
git:20261004.4b0ddb9 · audit A · 74,516 stars
404-page SKILL.md skill
thedaviddias/front-end-checklist · skills/404-page/SKILL.md · Use when reviewing templates, rendered HTML, or shared components related to Create a custom 404 error page. Validate…
git:20260529.7c05904 · audit A · 74,516 stars
about-page SKILL.md skill
thedaviddias/front-end-checklist · skills/about-page/SKILL.md · Use when auditing metadata, crawlability, structured data, or indexability related to Create a dedicated About page…
git:20260529.7c05904 · audit A · 74,516 stars
accessibility-testing SKILL.md skill
thedaviddias/front-end-checklist · skills/accessibility-testing/SKILL.md · Use when reviewing component libraries, page flows, or CI pipelines that need repeatable accessibility checks…
git:20260529.7c05904 · audit A · 74,516 stars
accessible-authentication SKILL.md skill
thedaviddias/front-end-checklist · skills/accessible-authentication/SKILL.md · Use when reviewing sign-in, sign-up, MFA, CAPTCHA, recovery, and re-auth flows. Evaluate the full authentication path…
git:20260529.7c05904 · audit A · 74,516 stars
accessible-notifications SKILL.md skill
thedaviddias/front-end-checklist · skills/accessible-notifications/SKILL.md · Use when reviewing templates, rendered HTML, or shared components related to Make notifications accessible. Validate…
git:20260529.7c05904 · audit A · 74,516 stars
accessible-tables SKILL.md skill
thedaviddias/front-end-checklist · skills/accessible-tables/SKILL.md · Use when reviewing rendered HTML, interactive components, or design-system patterns related to Use semantic table…
git:20260529.7c05904 · audit A · 74,516 stars
accessible-tooltips SKILL.md skill
thedaviddias/front-end-checklist · skills/accessible-tooltips/SKILL.md · Use when reviewing templates, rendered HTML, or shared components related to Create accessible tooltips. Validate the…
git:20260529.7c05904 · audit A · 74,516 stars
accesskeys SKILL.md skill
thedaviddias/front-end-checklist · skills/accesskeys/SKILL.md · Use when reviewing rendered HTML, interactive components, or design-system patterns related to Ensure accesskey values…
git:20260529.7c05904 · audit A · 74,516 stars

Every file in thedaviddias/front-end-checklist

Browse by kind, by grade A, or by owner.