Skip to content

feat: improve fixing-accessibility skill with WCAG 2.2 coverage - #37

Open
gonzoblasco wants to merge 1 commit into
ibelick:mainfrom
gonzoblasco:improve/fixing-accessibility-wcag22
Open

feat: improve fixing-accessibility skill with WCAG 2.2 coverage#37
gonzoblasco wants to merge 1 commit into
ibelick:mainfrom
gonzoblasco:improve/fixing-accessibility-wcag22

Conversation

@gonzoblasco

Copy link
Copy Markdown

Summary

Improves the fixing-accessibility skill with comprehensive WCAG 2.2 coverage, testing tools, and practical guidance.

Changes

WCAG 2.2 criteria added

  • Focus Appearance (2.4.11): minimum 2px thick, 3:1 contrast ratio against adjacent colors
  • Focus Not Obscured (2.4.12): focused element must not be hidden by sticky headers or floating panels
  • Target Size (2.5.8): minimum 24×24 CSS pixels for interactive targets
  • Dragging (2.5.7): provide single-pointer alternative for drag operations
  • Accessible Authentication (3.3.8): offer alternatives to cognitive function tests

New sections

  • Testing tools table: axe-core, Lighthouse, WAVE, Accessibility Insights, VoiceOver, NVDA, TalkBack, CCA, Accessibility Tree
  • Screen reader testing quick guide: VoiceOver (macOS) and NVDA (Windows) key commands
  • Touch and pointer: pointer cancellation (2.5.2), pointer gestures (2.5.1), dragging (2.5.7), target size (2.5.8)

Improvements

  • WCAG reference column added to priority table
  • Contrast section expanded with specific ratios (4.5:1, 3:1) and APCA mention
  • Non-text contrast (1.4.11) explicitly covered
  • More common fixes: focus indicator, target size, pointer cancellation, dragging alternative, accessible authentication
  • Landmark regions and aria-current added to semantics
  • aria-live guidance for dynamic content
  • Review guidance includes verification steps (automated + manual)
  • Tool boundaries: do not invent design intent

Why

The accessibility landscape evolves. WCAG 2.2 became a W3C Recommendation in October 2024, and agents should be aware of the new criteria. This update makes the skill production-ready for modern web development.

- Add WCAG 2.2 criteria: Focus Appearance (2.4.11), Focus Not Obscured (2.4.12),
  Target Size (2.5.8), Dragging (2.5.7), Accessible Authentication (3.3.8)
- Add testing tools section (axe, Lighthouse, WAVE, Accessibility Insights, CCA)
- Add screen reader testing quick guide (VoiceOver, NVDA)
- Add touch and pointer section (pointer cancellation, gestures, dragging)
- Improve contrast section with specific ratios and APCA mention
- Add more common fixes (focus indicator, target size, dragging alternative)
- Add WCAG reference column to priority table
- Expand review guidance with verification steps
@gonzoblasco

Copy link
Copy Markdown
Author

Quick ping - any updates on this? Happy to adjust the WCAG 2.2 coverage if the maintainers have specific formatting or scope preferences.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant