principle-accessibility

Installation
SKILL.md

Accessibility Principles

Accessibility bugs are correctness bugs. They are cheapest to fix before the first line of markup is written.

Semantic HTML First

Native elements carry built-in roles, keyboard behavior, and accessible names — no ARIA required.

  • Prefer <button> over <div role="button">; prefer <a href> over <span onClick>. Native elements are accessible by default.
  • Use landmark elements (<main>, <nav>, <header>, <footer>, <aside>) to define regions screen readers can navigate directly.
  • Maintain a logical heading hierarchy (h1 → h2 → h3); never skip levels to achieve visual styling.
  • Mark up lists with <ul>/<ol> + <li> — screen readers announce item count and position.
  • Use <table> with <th scope> and <caption> for tabular data; never for layout.

ARIA: Use Sparingly

The first rule of ARIA: do not use ARIA if a native HTML element already provides the semantics.

Installs
4
GitHub Stars
2
First Seen
May 21, 2026
principle-accessibility — lugassawan/swe-workbench