← ClaudeAtlas

docs-accessibilitylisted

Catch a11y issues in your docs before users hit them. Audits markdown for WCAG 2.1 AA violations a screen reader actually cares about — missing alt text, broken heading hierarchy, vague link anchors, captions and code-block language. Returns a prioritized fix list per page.
Docsbook-io/docs-skills · ★ 0 · AI & Automation · score 75
Install: claude install-skill Docsbook-io/docs-skills
# docs-accessibility — Accessibility Analysis (WCAG 2.1 AA) ## Workflow 1. **Connect to Docsbook** — run `list_workspaces` to find the workspace, then `get_doc_graph` to get all pages. Offer to add the repo if not indexed. Reindex with `reindex_doc_graph` if graph is empty or stale. 2. **Read pages** — use `read_doc_sections` to access content for pattern analysis. Prioritize Tier 1 pages (quick-start, pricing, auth) first. 3. **Apply checklist** — scan each page for the three big categories: alt text, heading hierarchy, and anchor text. Then cover lists, tables, code blocks, video, and text readability. 4. **Produce report** — return one JSON issue object per finding, sorted by severity. ## Guardrails - Contrast ratios and runtime keyboard behavior depend on the rendered theme — these require a live browser check and are out of scope for this skill. - This skill covers only what is detectable from markdown source. - Do not edit any documentation files — surface findings only. - Target WCAG 2.1 AA by default; ask before applying stricter AAA criteria. - Empty alt (`![]()`) is correct for decorative images — flag only when the surrounding context implies the image is informative. ## MCP Tools | Tool | Purpose | |------|---------| | `mcp__docsbook__list_workspaces` | Find workspace | | `mcp__docsbook__get_doc_graph` | Page list | | `mcp__docsbook__read_doc_sections` | Read content for a11y pattern analysis | | `mcp__docsbook__reindex_doc_graph` | Refresh graph if empty or