Skip to content

Conversation

@eovidiu
Copy link

@eovidiu eovidiu commented Nov 4, 2025

Summary

Add a comprehensive web accessibility checker skill for Claude Code that audits websites for WCAG 2.2 Level AA and EU EAA compliance.

What's New

This PR introduces a new Claude Code skill located in .claude/skills/web-accessibility-checker/ that provides automated and manual testing capabilities for web accessibility compliance.

Key Features:

  • Automated scanning using axe-core via Selenium to detect common accessibility violations
  • Manual testing checklist covering keyboard navigation, screen reader testing, form validation, and visual testing
  • Report generation that structures findings by WCAG's POUR principles (Perceivable, Operable, Understandable, Robust)
  • WCAG 2.2 compliance including all 9 new success criteria added in October 2023
  • EU EAA compliance focus with June 28, 2025 deadline awareness

Included Files:

  • SKILL.md - Main skill documentation and workflow (387 lines)
  • scripts/automated_checks.py - Python script for automated axe-core testing (303 lines)
  • scripts/generate_report.py - Report generator that formats violations by WCAG principle (313 lines)
  • references/wcag-22-criteria.md - Complete WCAG 2.2 success criteria reference (1,296 lines)
  • references/manual-testing-checklist.md - Step-by-step manual testing procedures (963 lines)
  • references/eaa-requirements.md - European Accessibility Act requirements and deadlines (517 lines)

Usage

Users can invoke this skill when asking to:

  • Check, audit, review, or assess website accessibility
  • Verify WCAG compliance
  • Test EU accessibility standards
  • Generate accessibility compliance reports

The skill follows a three-phase approach:

  1. Run automated tests with python scripts/automated_checks.py <url>
  2. Perform manual checks for keyboard navigation, screen readers, zoom, forms
  3. Generate structured reports with python scripts/generate_report.py violations.json

Why This Matters

  • The EU Accessibility Act (EAA) requires WCAG 2.2 Level AA compliance by June 28, 2025
  • Automated tools catch only ~30-40% of accessibility issues; this skill guides both automated and manual testing
  • Reports provide specific remediation guidance with code examples, not just issue detection
  • Structured by WCAG's POUR principles for better understanding and remediation prioritization

Testing

This is a Claude Code skill (documentation and scripts), not a website feature. No preview URL is applicable.

Dependencies for automation scripts:

pip install selenium axe-selenium-python webdriver-manager

Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Copy link
Contributor

@trieloff trieloff left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please eliminate the Python dependency.

Add comprehensive web accessibility checker skill for WCAG 2.2 Level AA and EU EAA compliance auditing.

Features:
- Automated scanning using axe-core via Playwright
- Manual testing checklists for keyboard navigation, screen readers, forms
- Report generation structured by WCAG POUR principles
- WCAG 2.2 compliance including all 9 new success criteria
- EU EAA compliance focus with June 28, 2025 deadline awareness

Included:
- SKILL.md - Main skill documentation and workflow
- scripts/automated-checks.js - Automated axe-core testing
- scripts/generate-report.js - Report generator
- references/wcag-22-criteria.md - Complete WCAG 2.2 reference
- references/manual-testing-checklist.md - Manual testing procedures
- references/eaa-requirements.md - EU Accessibility Act requirements

Scripts follow project coding standards:
- ES6 modules with explicit .js extensions
- Airbnb eslint style guide compliance
- JSDoc documentation
- Unix line endings
@eovidiu eovidiu force-pushed the web-accessibility-checker branch from d6bd4c6 to 98a8001 Compare November 14, 2025 21:13
@eovidiu
Copy link
Author

eovidiu commented Nov 14, 2025

Please eliminate the Python dependency.

Done

@trieloff
Copy link
Contributor

@eovidiu I've added the ai-generated tag. If that is unfair, let me know.

@eovidiu
Copy link
Author

eovidiu commented Nov 15, 2025

@eovidiu I've added the ai-generated tag. If that is unfair, let me know.
not a problem. it should be marked this way

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants