accessibility-rules
$
npx mdskill add Community-Access/accessibility-agents/accessibility-rulesLookup accessibility rules across Word, Excel, PowerPoint, and PDF formats.
- Resolve compliance gaps in cross-format document accessibility audits.
- Integrates with specialized sub-agents for each document type.
- Maps findings to WCAG 2.2 success criteria for reporting.
- Delivers rule counts categorized by error, warning, or tip status.
SKILL.md
.github/skills/accessibility-rulesView on GitHub ↗
--- name: accessibility-rules description: Cross-format document accessibility rule reference with WCAG 2.2 mapping. Use when looking up accessibility rules for Word (DOCX-*), Excel (XLSX-*), PowerPoint (PPTX-*), or PDF (PDFUA.*, PDFBP.*, PDFQ.*) documents, or when mapping findings to WCAG success criteria for compliance reporting. --- # Document Accessibility Rules Reference ## Rule ID Prefixes | Prefix | Format | Sub-Agent | Count | |--------|--------|-----------|-------| | DOCX-E* | Word errors | word-accessibility | 9 rules | | DOCX-W* | Word warnings | word-accessibility | 6 rules | | DOCX-T* | Word tips | word-accessibility | 3 rules | | XLSX-E* | Excel errors | excel-accessibility | 8 rules | | XLSX-W* | Excel warnings | excel-accessibility | 5 rules | | XLSX-T* | Excel tips | excel-accessibility | 3 rules | | PPTX-E* | PowerPoint errors | powerpoint-accessibility | 7 rules | | PPTX-W* | PowerPoint warnings | powerpoint-accessibility | 6 rules | | PPTX-T* | PowerPoint tips | powerpoint-accessibility | 4 rules | | PDFUA.* | PDF/UA conformance | pdf-accessibility | 30 rules | | PDFBP.* | PDF best practices | pdf-accessibility | 22 rules | | PDFQ.* | PDF quality/pipeline | pdf-accessibility | 4 rules | | EPUB-E* | ePub errors | epub-accessibility | 7 rules | | EPUB-W* | ePub warnings | epub-accessibility | 6 rules | | EPUB-T* | ePub tips | epub-accessibility | 3 rules | ## WCAG 2.2 Criterion Mapping Complete tracking of all WCAG 2.2 Level A and AA success criteria. Criteria with document-specific rules list the rule IDs. Criteria requiring human judgment show "Manual review". Criteria that apply only to web/app contexts show a dash. See the **wcag-guide** agent for full explanations of each criterion. > **Note:** WCAG 2.2 removed 4.1.1 Parsing (it is "always satisfied" in modern user agents and no longer tested). ### Level A (Must Fix) | WCAG | Criterion | Related Rules | |------|-----------|---------------| | 1.1.1 | Non-text Content | DOCX-E001, XLSX-E001, PPTX-E001, PDFUA.IMG.ALT, EPUB-E005 | | 1.2.1 | Audio-only and Video-only (Prerecorded) | Manual review (embedded media) | | 1.2.2 | Captions (Prerecorded) | Manual review (embedded video) | | 1.2.3 | Audio Description or Media Alternative (Prerecorded) | Manual review (embedded video) | | 1.3.1 | Info and Relationships | DOCX-E002, DOCX-E003, DOCX-E005, XLSX-E002, XLSX-E004, PPTX-E004, PDFUA.TAGGED, PDFUA.HEADINGS | | 1.3.2 | Meaningful Sequence | PPTX-E006, PDFUA.READING_ORDER, EPUB-E006 | | 1.3.3 | Sensory Characteristics | Manual review (all formats) | | 1.4.1 | Use of Color | XLSX-E007, Manual review (other formats) | | 1.4.2 | Audio Control | Manual review (embedded audio) | | 2.1.1 | Keyboard | PDFUA.FORMS (interactive PDFs) | | 2.1.2 | No Keyboard Trap | PDFUA.FORMS (interactive PDFs) | | 2.1.4 | Character Key Shortcuts | --- (web/app-specific) | | 2.2.1 | Timing Adjustable | --- (web/app-specific) | | 2.2.2 | Pause, Stop, Hide | Manual review (animated content in documents) | | 2.3.1 | Three Flashes or Below Threshold | Manual review (animated content) | | 2.4.1 | Bypass Blocks | PDFUA.BOOKMARKS, PDFBP.NAV, EPUB-E004 | | 2.4.2 | Page Titled | DOCX-E004, XLSX-E006, PPTX-E002, PDFUA.TITLE, EPUB-E001 | | 2.4.3 | Focus Order | PDFUA.FORMS (interactive PDFs) | | 2.4.4 | Link Purpose (In Context) | DOCX-E006, XLSX-E005, PPTX-E005 | | 2.5.1 | Pointer Gestures | --- (web/app-specific) | | 2.5.2 | Pointer Cancellation | --- (web/app-specific) | | 2.5.3 | Label in Name | PDFUA.FORMS (interactive PDFs) | | 2.5.4 | Motion Actuation | --- (web/app-specific) | | 3.1.1 | Language of Page | DOCX-T001, XLSX-T003, PPTX-T004, PDFUA.LANG, EPUB-E003 | | 3.2.1 | On Focus | --- (web/app-specific) | | 3.2.2 | On Input | --- (web/app-specific) | | 3.2.6 | Consistent Help | --- (web/app-specific) | | 3.3.1 | Error Identification | PDFUA.FORMS (interactive PDFs) | | 3.3.2 | Labels or Instructions | PDFUA.FORMS (interactive PDFs) | | 3.3.7 | Redundant Entry | --- (web/app-specific) | | 4.1.2 | Name, Role, Value | DOCX-E009, PDFUA.FORMS, PDFUA.TAGS | ### Level AA (Should Fix) | WCAG | Criterion | Related Rules | |------|-----------|---------------| | 1.2.4 | Captions (Live) | --- (web/app-specific) | | 1.2.5 | Audio Description (Prerecorded) | Manual review (embedded video) | | 1.3.4 | Orientation | --- (web/mobile-specific) | | 1.3.5 | Identify Input Purpose | PDFUA.FORMS (interactive PDFs) | | 1.4.3 | Contrast (Minimum) | Manual review (Office formats), PDFBP.Contrast | | 1.4.4 | Resize Text | Manual review (PDF reflow) | | 1.4.5 | Images of Text | PDFBP.IMG_TEXT | | 1.4.10 | Reflow | Manual review (PDF reflow) | | 1.4.11 | Non-text Contrast | Manual review (all formats) | | 1.4.12 | Text Spacing | Manual review (PDF text spacing) | | 1.4.13 | Content on Hover or Focus | --- (web/app-specific) | | 2.4.5 | Multiple Ways | Manual review (multi-page documents) | | 2.4.6 | Headings and Labels | DOCX-E003, DOCX-E007, PDFUA.HEADINGS | | 2.4.7 | Focus Visible | PDFUA.FORMS (interactive PDFs) | | 2.4.11 | Focus Not Obscured (Minimum) | --- (web/app-specific) | | 2.5.7 | Dragging Movements | --- (web/app-specific) | | 2.5.8 | Target Size (Minimum) | Manual review (interactive PDFs) | | 3.1.2 | Language of Parts | Manual review (Office formats), PDFUA.LANG_PARTS | | 3.2.3 | Consistent Navigation | --- (web/app-specific) | | 3.2.4 | Consistent Identification | --- (web/app-specific) | | 3.3.3 | Error Suggestion | PDFUA.FORMS (interactive PDFs) | | 3.3.4 | Error Prevention (Legal, Financial, Data) | PDFUA.FORMS (interactive PDFs) | | 3.3.8 | Accessible Authentication (Minimum) | --- (web/app-specific) | | 4.1.3 | Status Messages | --- (web/app-specific) | ## Severity Definitions | Severity | Meaning | Impact on AT Users | |----------|---------|-------------------| | Error | Blocks access | Content is inaccessible or unusable with assistive technology | | Warning | Degrades experience | Content is accessible but the experience is poor or confusing | | Tip | Best practice | Content works but could be improved for better AT experience | ## Confidence Levels | Level | Weight | Meaning | |-------|--------|---------| | High | 1.0 | Sub-agent is certain this is a real issue | | Medium | 0.7 | Likely an issue but requires human judgment | | Low | 0.3 | Possible issue - flagged for review | ## Compliance Standards | Standard | Scope | Key Rules | |----------|-------|-----------| | WCAG 2.2 Level A | International | All error-level rules | | WCAG 2.2 Level AA | International | All error + warning rules | | Section 508 | US Federal | Mapped to WCAG 2.0 Level AA | | EN 301 549 | European Union | Mapped to WCAG 2.1 Level AA | | PDF/UA (ISO 14289) | PDF-specific | All PDFUA.* rules |
More from Community-Access/accessibility-agents
- Accessibility LeadAccessibility team lead and orchestrator. Use on EVERY task that involves web UI code, HTML, JSX, CSS, React components, web pages, or any user-facing web content. This agent coordinates the accessibility specialist team and ensures no accessibility requirement is missed. Runs the final review before any UI code is considered complete. Applies to any web framework or vanilla HTML/CSS/JS.
- Accessibility Regression DetectorDetects accessibility regressions by comparing audit results across commits/branches. Tracks score trends and validates previous fixes.
- Accessibility Statement GeneratorGenerates conformance/accessibility statements following W3C or EU model templates. Maps audit results to conformance claims, known limitations, and contact information.
- Accessibility Tool BuilderExpert in building accessibility scanning tools, rule engines, document parsers, report generators, and audit automation. WCAG criterion mapping, severity scoring, CLI/GUI scanner architecture, CI/CD integration.
- Accessibility TrackerTrack accessibility improvements across VS Code and any configured repos -- get summaries, deep dives, workspace reports, WCAG cross-references, and proactive alerts on a11y changes.
- Actions ManagerGitHub Actions command center -- view workflow runs, read logs, re-run failed jobs, manage workflows, and debug CI failures entirely from the editor. Bypasses the deeply nested, visually-dependent Actions UI that is largely inaccessible to screen readers.
- Alt Text & HeadingsAlternative text and heading structure specialist for web applications. Use when building or reviewing any page with images, icons, SVGs, videos, figures, charts, or heading hierarchies. Covers meaningful vs decorative images, complex image descriptions, heading levels, document outline, and landmark structure. Can analyze images visually, compare existing alt text against image content, and interactively suggest appropriate alternatives. Applies to any web framework or vanilla HTML/CSS/JS.
- Analytics & InsightsYour GitHub analytics command center -- team velocity, review turnaround, issue resolution metrics, contribution activity, bottleneck detection, and code churn analysis with dual markdown + HTML reports.
- ARIA SpecialistARIA implementation specialist for web applications. Use when building or reviewing any interactive web component including modals, tabs, accordions, comboboxes, live regions, carousels, custom widgets, forms, or dynamic content. Also use when reviewing ARIA usage for correctness. Applies to any web framework or vanilla HTML/CSS/JS.
- CI AccessibilityCI/CD accessibility agent. Sets up, manages, and troubleshoots accessibility CI pipelines. Supports baseline management, SARIF output, PR annotations, and threshold configuration. Works with GitHub Actions, Azure DevOps, GitLab CI, CircleCI, and Jenkins.