docs-accessibilitylisted
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