MCPInstall

table-accessibility

Design data tables that work for screen readers and cognitive accessibility. Use when creating or reviewing tables, data grids, comparison tables, pricing tables, or any tabular data. Triggers on: table, data table, grid, spreadsheet, comparison table, pricing table, screen reader table, table headers, scope, caption, complex table.

Installs
77
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/owl-listener/inclusive-design-skills --skill table-accessibility
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads table-accessibility automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Table Accessibility

Design tables that communicate structure and relationships — not just to sighted users scanning rows and columns, but to screen reader users who navigate one cell at a time.

When to Use a Table

Tables are for data that has relationships across two dimensions (rows and columns). Don't use tables for layout.

  • Use a table: comparing features across products, showing schedules, displaying data with consistent categories
  • Don't use a table: laying out a form, arranging cards, creating visual columns of unrelated content

Core Requirements

Every Table Needs Headers

  • Column headers: use <th> with scope="col"
  • Row headers: use <th> with scope="row"
  • Screen readers announce headers before each cell, so users always know which column and row they're in
  • Without headers, a screen reader user hears a stream of disconnected values with no context

Every Table Needs a Caption or Label

  • Use <caption> element for HTML tables
  • Or use aria-labelledby pointing to a visible heading
  • The caption describes what the table contains: "Pricing comparison for Standard, Pro, and Enterprise plans"
  • Not just "Table 1" or "Data"

Simple Tables Over Complex Tables

  • Prefer simple tables with one row of column headers
  • Avoid merged cells (colspan, rowspan) wherever possible
  • If merged cells are necessary, use proper headers/id/scope associations
  • If a table needs merged cells to make sense, consider whether it should be split into multiple simpler tables

Cognitive Accessibility for Tables

Visual Design

  • Zebra striping (alternating row colours) aids row tracking
  • Adequate cell padding (at least 8px) prevents crowding
  • Align numbers right, text left for readability
  • Highlight the header row with stronger contrast

Reduce Complexity

  • Maximum 5–7 columns for comfortable scanning
  • If more columns are needed, consider a different format or allow users to show/hide columns
  • Provide a summary or key takeaway above complex tables
  • Don't require horizontal scrolling — make tables responsive

Responsive Tables

  • On small screens: convert to card/list view where each row becomes a labelled card
  • Or allow horizontal scroll with a sticky first column
  • Never hide data on smaller screens without a way to access it
  • Test: can a mobile user access every piece of data?

Assessment Checklist

  • All tables have column and/or row headers with proper scope
  • All tables have a caption or accessible label
  • No merged cells (or properly associated headers if unavoidable)
  • Tables are responsive on small screens
  • Tables are not used for visual layout
  • Complex tables have a text summary of key findings
  • Cell padding and spacing support readability

FAQ

What does the table-accessibility skill do?

Design data tables that work for screen readers and cognitive accessibility. Use when creating or reviewing tables, data grids, comparison tables, pricing tables, or any tabular data. Triggers on: table, data table, grid, spreadsheet, comparison table, pricing table, screen reader table, table headers, scope, caption, complex table.

How do I install table-accessibility?

Run npx skills add https://github.com/owl-listener/inclusive-design-skills --skill table-accessibility in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/table-accessibility/ (personal) or .claude/skills/table-accessibility/ (project).

Which AI agents can use table-accessibility?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is table-accessibility safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains table-accessibility?

It is published by owl-listener in owl-listener/inclusive-design-skills. It has 77 recorded installs.

More from owl-listener/inclusive-design-skills

View all →

plain-language-design

owl-listener/inclusive-design-skills

Open the skill to read its SKILL.md instructions.

97 installs

keyboard-navigation

owl-listener/inclusive-design-skills

Open the skill to read its SKILL.md instructions.

97 installs

cognitive-load-assessment

owl-listener/inclusive-design-skills

Open the skill to read its SKILL.md instructions.

88 installs

responsive-review

owl-listener/inclusive-design-skills

Open the skill to read its SKILL.md instructions.

user-preference-respect

owl-listener/inclusive-design-skills

Open the skill to read its SKILL.md instructions.

82 installs

error-prevention-recovery

owl-listener/inclusive-design-skills

Open the skill to read its SKILL.md instructions.

81 installs

Popular frontend & design skills

View category →

setup-matt-pocock-skills

mattpocock/skills

Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.

Frontend & Design1.1M installs

frontend-design

anthropics/skills

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

OfficialFrontend & Design1M installs

hyperframes-animation

heygen-com/hyperframes

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

prototype

mattpocock/skills

Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.

Frontend & Design999.2K installs

hyperframes-core

heygen-com/hyperframes

The HyperFrames composition contract — build one renderable project. Use for composition structure, the data- timing attributes, class="clip", tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Frontend & Design930.5K installs

vercel-react-best-practices

vercel-labs/agent-skills

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

OfficialFrontend & Design843.1K installs