Website Accessibility Check
Designwebsite-accessibility-checkWebsite Accessibility Check is an Agent Skill for design published in the oocx/tfplan2md repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Run a focused accessibility pass for website changes (WCAG 2.1 AA-oriented).
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/oocx/tfplan2md/blob/HEAD/.github/skills/website-accessibility-check/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/website-accessibility-check, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Skill Instructions
Purpose
Provide a focused, repeatable accessibility checklist for changes to Eleventy-authored website pages and shared UI building blocks.
Hard Rules
Must
- For any changed page/component, confirm semantic structure and a sensible heading hierarchy.
- Ensure interactive elements are keyboard reachable and have visible focus.
- Ensure images/icons that convey meaning have appropriate alt text (decorative images should not add noise).
- Ensure links have descriptive text (avoid “click here”).
- For any forms/inputs, ensure there are labels (or equivalent accessible names).
- Run
scripts/website-verify.sh --alland fix failures before claiming done. - When shared authored sources change (
_includes,_data,styles,site-assets, orexamples), validate at least one representative consuming page in the renderedwebsite/dist/output.
Must Not
- Do not claim “done” if basic keyboard navigation is broken.
- Do not introduce new UI patterns without considering accessibility impact.
Quick Checklist (per changed page)
- Structure: one clear
h1, no heading level jumps where avoidable - Landmarks: use semantic elements (
header,nav,main,footer) where appropriate - Keyboard: tab order is logical; focus is visible; no traps
- Images: meaningful images have alt; decorative images don’t distract screen readers
- Links: text is descriptive and unique enough in context
- Color/contrast: avoid low-contrast text and “color-only” meaning
Suggested Workflow (VS Code)
- Open the changed page via the VS Code preview server (
http://127.0.0.1:3000/website/dist/), then use thebrowser/*tools or thewebsite-devtoolsskill to inspect DOM, focus order, and console state. - Use keyboard only (Tab/Shift+Tab/Enter/Space) to navigate key flows.
- Spot-check headings and landmark structure in the DOM.
- If shared components or layouts changed, repeat the checks on multiple pages that use them.
- If available, use the
website-devtoolsskill to validate focus states, responsive behavior, and console errors.