Skip to content
cccskills
FreePublished on GitHubEnglish overview

aria-required-parent

Review whether ARIA roles, which describe interface elements to assistive technology, have the required parent roles. Find misplaced menu items, tabs, or list items, suggest suitable containers, and explain how to verify the corrected structure.

OriginalShow the original description

Use when reviewing rendered HTML, interactive components, or design-system patterns related to Ensure ARIA roles are contained by required parent roles. Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output where relevant.

AI rating90/ 100See how to install

Good for

  • Checking parent roles for menu items
  • Reviewing tab and list structures
  • Auditing design-system components
  • Investigating screen-reader grouping problems

Overview

What it does

Checks whether menu items, tabs, and list items sit within the parent roles they require. ARIA roles describe an element's purpose to assistive technology. For example, it checks whether an element with role="listitem" has a parent with role="list", and suggests wrapping elements in suitable containers. It also explains why these relationships matter for spoken output and navigation within a group.

When it helps

Use it to review custom menus, tabs, and design-system components. It also helps investigate cases where items appear together on screen but a screen reader does not recognize them as one group.

Example requests

  • “Check the parent-child relationships between this menu's ARIA roles.”
  • “Check whether these tabs and list items have the required parent roles.”
  • “Show the changes needed and the steps for checking them with a screen reader.”

Notes

Review the rendered HTML and states that change during interaction. Check the meaning provided by native HTML elements first, then examine keyboard interaction and focus movement where needed. Verify fixes with browser accessibility tools or assistive technology.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Objective evaluation

AI rated this skill on four points using only the contents of its SKILL.md. Stars and popularity are not taken into account.

Clear instructionsIs it clear when to use it and what it does?
AGoodIt explicitly checks required parent roles for ARIA roles in rendered HTML and interactive components.
Concrete stepsAre steps, inputs, outputs, and examples spelled out?
AGoodIt gives a listitem-in-list fix and requires identifying problem locations and verification methods using assistive technology.
SafetyAre sending data, deleting files, and running commands disclosed?
AGoodThe documented work covers structural and interaction checks and proposed fixes, with no deletion or credential operations.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingVerification uses browser accessibility tools or assistive technology, but specific tool setup is not provided.

The total counts each point as A = 25, B = 15, C = 5. Rated by AI (OpenAI Codex) as of Oct 23, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (2)

  • SKILL.md1.9 KB
  • references/rule.md2.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Ensure ARIA roles are contained by required parent roles

If an ARIA child role (like a menu item) is not contained within its required parent role (like a menu), screen readers may fail to announce the item as part of a group, breaking navigation.

Quick Reference

  • Certain roles (like listitem) must be owned by specific parent roles (like list)
  • Ensure children elements are not orphaned from their semantic containers
  • Maintain valid ARIA hierarchies for menu items, tabs, and list items

Check

Verify that elements with roles like listitem, tab, or menuitem are correctly nested within their required parent roles.

Fix

Wrap elements with roles that require a specific parent in the appropriate container role (e.g., wrap role="listitem" in role="list").

Explain

Explain why certain ARIA roles must be nested within specific parent containers to maintain semantic meaning and group navigation.

Code Review

Review the rendered markup and interactive states that affect Ensure ARIA roles are contained by required parent roles. 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-required-parent

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

404-page

FreeSummary

Create and review custom 404 pages that help visitors recover from broken or moved links through search and navigation. Check the rendered page and HTTP response so missing content returns a proper 404 status.

  • Creating a helpful custom 404 page
  • Adding search and navigation for broken links
  • Checking missing pages that return HTTP 200
thedaviddias/Front-End-Checklist74.5KUpdated Oct 6, 2026

about-page

FreeSummary

Audit or create a dedicated About page that explains a website’s purpose and identifies its people or organization. Review the rendered output and supporting information, including expertise and contact details, to find gaps.

  • Reviewing a website’s About page
  • Creating a page about the organization and its mission
  • Checking how operator information appears in rendered output
thedaviddias/Front-End-Checklist74.5KUpdated Oct 6, 2026

accessibility-testing

FreeSummaryAI rating 80

Review and add automated accessibility checks for components, pages, and continuous integration workflows. Use axe-based tools to detect structural and attribute issues, while identifying checks that still need keyboard or screen reader testing.

  • Review accessibility coverage for shared components
  • Add accessibility checks to page flow tests
  • Run accessibility tests in CI
thedaviddias/Front-End-Checklist74.5KUpdated Oct 6, 2026

accessible-authentication

FreeSummaryAI rating 90

Review sign-in, registration, multi-factor authentication, and account recovery for accessibility barriers. Find blocked paste, difficult code entry, and inaccessible backup methods, then suggest authentication paths that support password managers, autofill, or device approval.

  • Reviewing accessibility across the sign-in process
  • Checking verification code paste and autofill
  • Inspecting password reset and account recovery
thedaviddias/Front-End-Checklist74.5KUpdated Oct 6, 2026

accessible-notifications

FreeSummaryAI rating 100

Review form errors, success messages, and live updates so screen reader users receive important notifications. Check the HTML delivered to the browser, announcement settings, display duration, and dismissal controls, then identify specific elements that need changes.

  • Reviewing form error announcements
  • Checking success message display duration
  • Auditing live update notifications
thedaviddias/Front-End-Checklist74.5KUpdated Oct 6, 2026

accessible-tables

FreeSummaryAI rating 100

Review HTML tables so screen reader users can understand how headers and data relate. Check header markup, table descriptions, and merged cells, then identify specific fixes and ways to verify them.

  • Reviewing tables for screen reader accessibility
  • Checking header relationships in tables with merged cells
  • Reviewing table patterns in a design system
thedaviddias/Front-End-Checklist74.5KUpdated Oct 6, 2026

See all skills by thedaviddias

Report a problem with this skill