accessible-tables
Installation
SKILL.md
Use semantic table markup for screen readers
Screen readers read table data cell-by-cell—without proper headers, users hear meaningless numbers without context. 'Row 3, Column 2: $99' vs just '$99'.
Quick Reference
- Use elements for headers with scope='col' or scope='row'
- Add to describe the table's purpose
- Never use tables for layout—use CSS Grid or Flexbox instead
- Use id/headers for complex tables with merged cells
- For simple tables with a clear adjacent section heading, missing
scopeis often a stronger finding than missing<caption> - Prefer one strong table-semantics finding over multiple weaker enhancements on the same simple table
Check
Verify tables use proper th elements with scope, caption or aria-labelledby, and semantic table structure.