Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
community-access avatar

Accessibility Rules

  • 186 installs
  • 381 repo stars
  • Updated August 4, 2026
  • community-access/accessibility-agents

Encode WCAG-oriented rules so coding agents apply consistent accessibility constraints while generating or editing UI markup, components, and interaction patterns.

About

Defines accessibility rules for AI agents building web interfaces, translating WCAG expectations into actionable checks for semantics, focus management, ARIA usage, color contrast, and inclusive interaction patterns across generated frontend code and design iterations.

  • WCAG rule encoding
  • ARIA usage guidance
  • Keyboard navigation patterns
  • Color contrast expectations
  • Semantic HTML requirements

Accessibility Rules by the numbers

  • 186 all-time installs (skills.sh)
  • Ranked #953 of 1,880 Design & UI/UX skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/community-access/accessibility-agents --skill accessibility-rules

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs186
repo stars381
Last updatedAugust 4, 2026
Repositorycommunity-access/accessibility-agents

What it does

Encode WCAG-oriented rules so coding agents apply consistent accessibility constraints while generating or editing UI markup, components, and interaction patterns.

Files

SKILL.mdMarkdownGitHub ↗

<!-- CANONICAL SOURCE: .github/skills/accessibility-rules/SKILL.md -- Edit the canonical source; sync to Gemini via scripts/check-gemini-sync.ps1 -->

Document Accessibility Rules Reference

Rule ID Prefixes

PrefixFormatSub-AgentCount
DOCX-E*Word errorsword-accessibility9 rules
DOCX-W*Word warningsword-accessibility6 rules
DOCX-T*Word tipsword-accessibility3 rules
XLSX-E*Excel errorsexcel-accessibility8 rules
XLSX-W*Excel warningsexcel-accessibility5 rules
XLSX-T*Excel tipsexcel-accessibility3 rules
PPTX-E*PowerPoint errorspowerpoint-accessibility7 rules
PPTX-W*PowerPoint warningspowerpoint-accessibility6 rules
PPTX-T*PowerPoint tipspowerpoint-accessibility4 rules
PDFUA.*PDF/UA conformancepdf-accessibility30 rules
PDFBP.*PDF best practicespdf-accessibility22 rules
PDFQ.*PDF quality/pipelinepdf-accessibility4 rules
EPUB-E*ePub errorsepub-accessibility7 rules
EPUB-W*ePub warningsepub-accessibility6 rules
EPUB-T*ePub tipsepub-accessibility3 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)

WCAGCriterionRelated Rules
1.1.1Non-text ContentDOCX-E001, XLSX-E001, PPTX-E001, PDFUA.IMG.ALT, EPUB-E005
1.2.1Audio-only and Video-only (Prerecorded)Manual review (embedded media)
1.2.2Captions (Prerecorded)Manual review (embedded video)
1.2.3Audio Description or Media Alternative (Prerecorded)Manual review (embedded video)
1.3.1Info and RelationshipsDOCX-E002, DOCX-E003, DOCX-E005, XLSX-E002, XLSX-E004, PPTX-E004, PDFUA.TAGGED, PDFUA.HEADINGS
1.3.2Meaningful SequencePPTX-E006, PDFUA.READING_ORDER, EPUB-E006
1.3.3Sensory CharacteristicsManual review (all formats)
1.4.1Use of ColorXLSX-E007, Manual review (other formats)
1.4.2Audio ControlManual review (embedded audio)
2.1.1KeyboardPDFUA.FORMS (interactive PDFs)
2.1.2No Keyboard TrapPDFUA.FORMS (interactive PDFs)
2.1.4Character Key Shortcuts--- (web/app-specific)
2.2.1Timing Adjustable--- (web/app-specific)
2.2.2Pause, Stop, HideManual review (animated content in documents)
2.3.1Three Flashes or Below ThresholdManual review (animated content)
2.4.1Bypass BlocksPDFUA.BOOKMARKS, PDFBP.NAV, EPUB-E004
2.4.2Page TitledDOCX-E004, XLSX-E006, PPTX-E002, PDFUA.TITLE, EPUB-E001
2.4.3Focus OrderPDFUA.FORMS (interactive PDFs)
2.4.4Link Purpose (In Context)DOCX-E006, XLSX-E005, PPTX-E005
2.5.1Pointer Gestures--- (web/app-specific)
2.5.2Pointer Cancellation--- (web/app-specific)
2.5.3Label in NamePDFUA.FORMS (interactive PDFs)
2.5.4Motion Actuation--- (web/app-specific)
3.1.1Language of PageDOCX-T001, XLSX-T003, PPTX-T004, PDFUA.LANG, EPUB-E003
3.2.1On Focus--- (web/app-specific)
3.2.2On Input--- (web/app-specific)
3.2.6Consistent Help--- (web/app-specific)
3.3.1Error IdentificationPDFUA.FORMS (interactive PDFs)
3.3.2Labels or InstructionsPDFUA.FORMS (interactive PDFs)
3.3.7Redundant Entry--- (web/app-specific)
4.1.2Name, Role, ValueDOCX-E009, PDFUA.FORMS, PDFUA.TAGS

Level AA (Should Fix)

WCAGCriterionRelated Rules
1.2.4Captions (Live)--- (web/app-specific)
1.2.5Audio Description (Prerecorded)Manual review (embedded video)
1.3.4Orientation--- (web/mobile-specific)
1.3.5Identify Input PurposePDFUA.FORMS (interactive PDFs)
1.4.3Contrast (Minimum)Manual review (Office formats), PDFBP.Contrast
1.4.4Resize TextManual review (PDF reflow)
1.4.5Images of TextPDFBP.IMG_TEXT
1.4.10ReflowManual review (PDF reflow)
1.4.11Non-text ContrastManual review (all formats)
1.4.12Text SpacingManual review (PDF text spacing)
1.4.13Content on Hover or Focus--- (web/app-specific)
2.4.5Multiple WaysManual review (multi-page documents)
2.4.6Headings and LabelsDOCX-E003, DOCX-E007, PDFUA.HEADINGS
2.4.7Focus VisiblePDFUA.FORMS (interactive PDFs)
2.4.11Focus Not Obscured (Minimum)--- (web/app-specific)
2.5.7Dragging Movements--- (web/app-specific)
2.5.8Target Size (Minimum)Manual review (interactive PDFs)
3.1.2Language of PartsManual review (Office formats), PDFUA.LANG_PARTS
3.2.3Consistent Navigation--- (web/app-specific)
3.2.4Consistent Identification--- (web/app-specific)
3.3.3Error SuggestionPDFUA.FORMS (interactive PDFs)
3.3.4Error Prevention (Legal, Financial, Data)PDFUA.FORMS (interactive PDFs)
3.3.8Accessible Authentication (Minimum)--- (web/app-specific)
4.1.3Status Messages--- (web/app-specific)

Severity Definitions

SeverityMeaningImpact on AT Users
ErrorBlocks accessContent is inaccessible or unusable with assistive technology
WarningDegrades experienceContent is accessible but the experience is poor or confusing
TipBest practiceContent works but could be improved for better AT experience

Confidence Levels

LevelWeightMeaning
High1.0Sub-agent is certain this is a real issue
Medium0.7Likely an issue but requires human judgment
Low0.3Possible issue - flagged for review

Compliance Standards

StandardScopeKey Rules
WCAG 2.2 Level AInternationalAll error-level rules
WCAG 2.2 Level AAInternationalAll error + warning rules
Section 508US FederalMapped to WCAG 2.0 Level AA
EN 301 549European UnionMapped to WCAG 2.1 Level AA
PDF/UA (ISO 14289)PDF-specificAll PDFUA.* rules

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.