html-accessibility

Installation
SKILL.md

HTML Accessibility

Practical, non-negotiable accessibility patterns for every web project. This skill focuses on what you must always do -- the minimum viable accessibility that ensures screenreaders can parse your HTML, keyboards can navigate it, and users with disabilities can use it.

This is not about achieving WCAG AAA perfection on every project. It's about never shipping inaccessible basics -- labels on inputs, alt on images, semantic structure, keyboard operability. These patterns cost almost nothing to implement but make a massive difference.

Core Principle

Use the right HTML element for the right job. Semantic HTML provides built-in accessibility for free. Every <div> that should be a <button>, every missing <label>, every decorative image without alt="" is a barrier you chose to create. The first rule of ARIA: don't use ARIA if native HTML can do it.

Scoring

Goal: 10/10. Rate HTML output 0-10 based on accessibility compliance.

  • 9-10: All inputs labelled, semantic structure correct, keyboard-navigable, images have appropriate alt, ARIA used only when necessary. Passes automated tools (axe, Lighthouse) with zero errors.
  • 7-8: Most patterns correct. Minor gaps: one missing alt, a decorative image with redundant alt text, one fieldset without legend.
  • 5-6: Basics present but inconsistent. Some labels missing, heading hierarchy broken, some interactive elements not keyboard-accessible.
  • 3-4: Significant gaps. Many inputs without labels, divs used as buttons, no landmark structure, images without alt.
  • 1-2: No accessibility consideration. Screenreaders cannot parse the page. Keyboard users cannot navigate.
Installs
2
GitHub Stars
4
First Seen
Jun 18, 2026
html-accessibility — alpham8/agentic-webdev