feat: update a11y skill and references#89
Merged
Conversation
jorgecoca
approved these changes
May 6, 2026
Contributor
jorgecoca
left a comment
jorgecoca
left a comment
There was a problem hiding this comment.
LGTM.
Note for the future: when cupertino/material split out of the core libraries, we will need to push a new update
RuiMiguel
reviewed
May 7, 2026
ryzizub
reviewed
May 11, 2026
Contributor
… files
Implement feedback to split platform-specific checks into separate files (iOS, Android, Web, macOS, Windows, Linux) so Claude loads only the platforms being audited, saving tokens on multi-platform audits.
Changes:
- Create references/platforms/{ios,android,web,macos,windows,linux}.md with per-platform WCAG 2.2 checks, testing tools, and Flutter-specific gotchas
- Delete references/platform-matrix.md (consolidated into per-platform files)
- Update SKILL.md to reference platform files in Phase 2 and Additional Resources
- Move cross-platform severity table from platform-matrix.md into audit-templates.md
- Update widget-mapping.md links from WCAG 2.1 to WCAG 2.2
All platforms now cite WCAG 2.2 (not 2.1). Per-platform content includes latest Flutter quirks (iOS liveRegion bug, Android headingLevel regression in 3.38.0, web semantics opt-in, etc.).
Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
…ency Implement XML structural tags in SKILL.md to improve Claude's parsing efficiency: - Wrap core standards in <rule> tags with wcag IDs for easy reference - Add <phase> tags around workflow phases 1-4 with metadata (id, name) - Tag <action>, <outcome>, <question>, <constraint>, <finding-format> within phases - Add <category> tags for the 7 audit check categories with ids - Wrap anti-patterns in <antipattern> tags with category and wcag attributes - Add <instructions>, <context> tags for structural clarity This XML structure helps Claude understand the organization without affecting markdown readability. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
The CLAUDE.md project guidelines specify only these frontmatter fields: - name (required) - description (required) — describes when the skill should be triggered - allowed-tools (optional) - argument-hint (optional) Remove the non-standard `when_to_use` and `effort` fields. Consolidate the "when to use" context into the `description` field per project conventions. Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
ryzizub
reviewed
May 27, 2026
RuiMiguel
reviewed
May 28, 2026
RuiMiguel
reviewed
May 28, 2026
RuiMiguel
reviewed
May 28, 2026
RuiMiguel
reviewed
May 28, 2026
RuiMiguel
reviewed
May 28, 2026
RuiMiguel
reviewed
May 28, 2026
RuiMiguel
reviewed
May 28, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Update the accessibility reference and skills files to match WCAG 2.2.
Type of Change
feat)fix)refactor)docs)ci)chore)