table-headers
Installation
SKILL.md
Define proper table headers
Properly defined headers allow screen readers to announce the context for each data cell, making complex tables understandable.
Quick Reference
- Use
<th>for all table headers, not<td> - Apply
scope="col"orscope="row"to clarify header relationship - Ensure every data cell is associated with at least one header
- In simple tables, prefer fixing header associations before escalating to caption-level recommendations
- Missing
scope="col"on a straightforward header row is often the clearest first fix
Check
Check that all data tables use <th> elements for headers with appropriate scope attributes.
Fix
Convert header cells to <th> and add the correct scope attribute.