site-accessibility-layout

Build and review accessible website layouts with WCAG 2.2 semantics, focus management, and keyboard support.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/TECH-HY/SKILLS --skill site-accessibility-layout-tech-hy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-accessibility-layout
Source: https://github.com/TECH-HY/SKILLS/tree/main/skills/site-accessibility-layout
Command: npx skills add https://github.com/TECH-HY/SKILLS --skill site-accessibility-layout-tech-hy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Website layouts, forms, menus, and custom widgets often ship with broken semantics, missing keyboard paths, and poor focus handling, making them unusable for keyboard and screen-reader users. This Skill treats accessibility as a first-class implementation constraint rather than a final polish pass. ## Core Features & Use Cases - Semantic Layout Baseline: Apply a WCAG 2.2-aware page skeleton with landmarks, skip links, and correct heading hierarchy before adding ARIA. - Focus and Navigation Guidance: Implement dialogs, menus, tabs, and drag-and-drop alternatives with complete keyboard paths and correct focus return behavior. - Accessible Forms: Build forms with programmatic labels, inline field errors, and page-level error summaries that explain how to recover. - Use Case: When auditing an existing page template, use this Skill to convert findings into structural fixes, keyboard and focus fixes, and content and label fixes. ## Quick Start Use the site-accessibility-layout skill to review this page template and make it semantic, keyboard-safe, and WCAG 2.2 compliant.

Frequently Asked Questions about site-accessibility-layout

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make a website layout WCAG 2.2 accessible?

Start with semantic HTML landmarks, a skip link, and correct heading hierarchy before adding any ARIA. Then verify keyboard users can reach all major actions, focus stays visible and unobscured, and interactive targets are touch-friendly.

How do I handle focus management in modals and dialogs?

Move focus to a meaningful element when the dialog opens, keep background content non-interactable while modal, and return focus to the invoking control on close. Only trap focus inside true modal contexts and provide an escape or close action.

When should I use ARIA instead of native HTML?

Use native HTML semantics first and treat ARIA as a supplement, not a substitute. Only add ARIA roles and attributes when a custom widget cannot be expressed with native elements, and define its keyboard behavior and labels explicitly.

How do I make form validation accessible for screen readers?

Combine inline field errors near each invalid control with a page-level error summary that links to those fields. Move focus to the summary after a failed submit, keep messages specific, and preserve valid user input.

What are alternatives to drag-and-drop for keyboard users?

Provide an equal-outcome alternative such as move up or move down buttons, a destination selection menu, or explicit source and target selectors. The requirement is equal outcome, not an identical interaction.