Skip to content
UXClaim
Accessibility

WordPress Accessibility

Enforce WCAG 2.1 AA compliance in WordPress themes with automated checks for screen readers, keyboard navigation, color contrast, and focus management.

What It Does

This Claude Code skill automates accessibility auditing and enforcement for WordPress themes, ensuring WCAG 2.1 AA compliance across your entire site. It validates screen reader compatibility, keyboard navigation patterns, color contrast ratios, and focus management systems.

How It Works

The skill integrates directly into your Claude Code workflow, activating automatically when you’re working on WordPress accessibility tasks. It provides real-time validation against WCAG standards, checking for skip links, semantic landmarks, form accessibility, and proper ARIA attributes.

Key Features

  • Screen Reader Support: Validates semantic HTML and ARIA labels
  • Keyboard Navigation: Ensures all interactive elements are keyboard accessible
  • Color Contrast: Audits text and UI contrast ratios against AA standards
  • Focus Management: Identifies and fixes focus order and visible focus indicators
  • Form Accessibility: Validates form labels, error messaging, and input types

Use Cases

  • Auditing existing WordPress theme accessibility
  • Building new accessible themes from scratch
  • Fixing accessibility issues during design reviews
  • Training teams on WCAG compliance requirements
  • Documenting accessibility improvements for stakeholders

Who Benefits

Design system builders, accessibility specialists, UX designers, and product managers ensuring inclusive WordPress experiences.

Frequently asked questions

How do I install the WordPress Accessibility skill?
Install via Claude Code Plugin Marketplace with `/plugin install https://github.com/xonack/wp-accessibility-claude-skill` or manually copy the SKILL.md file to ~/.claude/skills/wp-accessibility/. Once installed, it activates automatically for WordPress tasks or invoke with `/wp-accessibility`.
What WCAG standards does this skill check?
The skill enforces WCAG 2.1 AA compliance, covering critical accessibility areas: skip links, semantic landmarks, color contrast ratios (4.5:1 for normal text), keyboard navigation, form accessibility, screen reader support via ARIA attributes, and focus management indicators.
Can this skill check color contrast automatically?
Yes, it audits color contrast ratios for both text and UI components, ensuring they meet WCAG AA standards (4.5:1 for normal text, 3:1 for large text). It identifies contrast violations in your theme and suggests improvements.
Does it work with screen readers?
The skill validates screen reader compatibility by checking semantic HTML structure, proper heading hierarchy, ARIA labels, alt text, and landmark regions. It helps ensure your WordPress content is properly announced to assistive technologies.
How does keyboard navigation checking work?
It validates that all interactive elements (buttons, links, form inputs) are keyboard accessible, focus indicators are visible, tab order is logical, and keyboard traps are eliminated. This ensures users without mice can navigate your site completely.
Can I use this for accessibility audits?
Yes, this is ideal for accessibility audits. It provides automated WCAG compliance checking across your entire theme, identifies violations with specific remediation guidance, and helps document accessibility improvements for stakeholders.
What form accessibility does it validate?
The skill checks form labels are properly associated with inputs, error messages are accessible and linked to fields, input types are semantically correct, fieldsets group related inputs, and required fields are marked. This ensures forms work for all users.
Is this skill free to use?
Yes, the skill is open source under the MIT license and free to use. You can install it directly from GitHub or contribute improvements via pull requests.

Glossary

WCAG 2.1 AA
Web Content Accessibility Guidelines level AA - the mid-tier conformance level covering essential accessibility requirements like color contrast (4.5:1), keyboard navigation, and screen reader support that benefits users with disabilities.
Screen Reader
Assistive software that reads website content aloud to blind and low-vision users. It interprets semantic HTML, ARIA labels, and proper heading structure to convey page meaning.
Focus Management
The practice of controlling where keyboard users land when navigating with Tab key, ensuring visible focus indicators and logical tab order through interactive elements.
Semantic HTML
Using HTML tags that clearly describe their meaning (like <button>, <nav>, <main>) rather than generic divs, enabling screen readers and assistive tech to understand page structure.
ARIA Attributes
Accessible Rich Internet Applications attributes (aria-label, aria-describedby, role) that add accessibility information to HTML elements when semantic markup isn't sufficient.

More in Accessibility

All →
Accessibility

A&T Claude Skills

Reusable Claude Code skills for accessibility audits, WCAG compliance checking, and web development workflows

automateandtweak
Accessibility

a11y-skills

Claude Skills for accessibility auditing, code review, and WCAG 2.2 compliance across web, mobile, and documents.

joedevon