How do I install the A11Y skill?

Run npx skillmds@latest add launch52-ai/a11y in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with A11Y?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

launch52-ai (@launch52-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

A11Y by launch52-ai — Agent Skill

Name: A11Y
Author: launch52-ai

A11Y

Audit and implement accessibility in Flutter apps. Use when adding semantic labels, testing screen reader compatibility, ensuring WCAG compliance, fixing accessibility issues, or making UI accessible to all users. Covers Semantics widgets, contrast ratios, touch targets, and assistive technology support.

launch52-ai ddbdbd9 5 files · 68.5 KB Updated Sep 17, 2026

File contents

a11y - Accessibility Implementation

Make Flutter apps accessible to everyone. Semantic labels, screen reader support, WCAG compliance.

When to Use This Skill

Adding semantic labels to custom widgets
Auditing code for accessibility issues
Testing with screen readers (TalkBack/VoiceOver)
Fixing accessibility violations
Implementing focus management

Quick Reference

The Four Pillars

Perceivable - Semantic labels, contrast ≥4.5:1, text scaling
Operable - Touch targets ≥48dp, focus order, keyboard nav
Understandable - Clear labels, error guidance
Robust - Semantics widget, live regions, proper roles

Key Requirements

Check	Requirement	Test
Contrast	≥4.5:1	`textContrastGuideline`
Touch targets	≥48×48dp	`androidTapTargetGuideline`
Labels	All interactive	`labeledTapTargetGuideline`

Commands

# Audit for accessibility issues
dart run .claude/skills/a11y/scripts/check.dart

# Audit specific feature
dart run .claude/skills/a11y/scripts/check.dart --feature auth

# Generate accessibility test file
dart run .claude/skills/a11y/scripts/check.dart --generate-tests feature_name

Workflow

1. Audit

dart run .claude/skills/a11y/scripts/check.dart --feature {feature}

Look for: Images without semanticLabel, IconButton without tooltip, custom widgets without Semantics.

2. Add Semantics

Use patterns from semantics-guide.md:

Images: semanticLabel property
Icon buttons: tooltip property
Custom widgets: Semantics wrapper

3. Test

Add accessibility tests per testing-guide.md:

await expectLater(tester, meetsGuideline(textContrastGuideline));
await expectLater(tester, meetsGuideline(androidTapTargetGuideline));
await expectLater(tester, meetsGuideline(labeledTapTargetGuideline));

4. Manual Verification

Test with VoiceOver (iOS) and TalkBack (Android). All controls should be announced clearly.

Guides

Guide	Use For
semantics-guide.md	Semantics widget patterns, roles, labels, focus
testing-guide.md	Automated and manual a11y testing
examples.md	Complete accessible Flutter code

Checklist

Images have semanticLabel or ExcludeSemantics
IconButton has tooltip
Custom widgets have Semantics wrapper
Touch targets ≥48×48dp
Text contrast ≥4.5:1
Focus order matches visual layout
Tested with VoiceOver/TalkBack
Accessibility labels use i18n (t.feature.accessibility.key)

Related Skills

/design - Touch targets, contrast (visual aspects)
/testing - Add accessibility tests with other tests
/i18n - Localize accessibility labels

---name: a11ydescription: Audit and implement accessibility in Flutter apps. Use when adding semantic labels, testing screen reader compatibility, ensuring WCAG compliance, fixing accessibility issues, or making UI accessible to all users. Covers Semantics widgets, contrast ratios, touch targets, and assistive technology support.---# a11y - Accessibility ImplementationMake Flutter apps accessible to everyone. Semantic labels, screen reader support, WCAG compliance.## When to Use This Skill- Adding semantic labels to custom widgets- Auditing code for accessibility issues- Testing with screen readers (TalkBack/VoiceOver)- Fixing accessibility violations- Implementing focus management## Quick Reference### The Four Pillars1. **Perceivable** - Semantic labels, contrast ≥4.5:1, text scaling2. **Operable** - Touch targets ≥48dp, focus order, keyboard nav3. **Understandable** - Clear labels, error guidance4. **Robust** - Semantics widget, live regions, proper roles### Key Requirements| Check | Requirement | Test ||-------|-------------|------|| Contrast | ≥4.5:1 | `textContrastGuideline` || Touch targets | ≥48×48dp | `androidTapTargetGuideline` || Labels | All interactive | `labeledTapTargetGuideline` |### Commands```bash# Audit for accessibility issuesdart run .claude/skills/a11y/scripts/check.dart# Audit specific featuredart run .claude/skills/a11y/scripts/check.dart --feature auth# Generate accessibility test filedart run .claude/skills/a11y/scripts/check.dart --generate-tests feature_name```## Workflow### 1. Audit```bashdart run .claude/skills/a11y/scripts/check.dart --feature {feature}```Look for: Images without `semanticLabel`, `IconButton` without `tooltip`, custom widgets without `Semantics`.### 2. Add SemanticsUse patterns from [semantics-guide.md](semantics-guide.md):- Images: `semanticLabel` property- Icon buttons: `tooltip` property- Custom widgets: `Semantics` wrapper### 3. TestAdd accessibility tests per [testing-guide.md](testing-guide.md):```dartawait expectLater(tester, meetsGuideline(textContrastGuideline));await expectLater(tester, meetsGuideline(androidTapTargetGuideline));await expectLater(tester, meetsGuideline(labeledTapTargetGuideline));```### 4. Manual VerificationTest with VoiceOver (iOS) and TalkBack (Android). All controls should be announced clearly.## Guides| Guide | Use For ||-------|---------|| [semantics-guide.md](semantics-guide.md) | Semantics widget patterns, roles, labels, focus || [testing-guide.md](testing-guide.md) | Automated and manual a11y testing || [examples.md](examples.md) | Complete accessible Flutter code |## Checklist- [ ] Images have `semanticLabel` or `ExcludeSemantics`- [ ] `IconButton` has `tooltip`- [ ] Custom widgets have `Semantics` wrapper- [ ] Touch targets ≥48×48dp- [ ] Text contrast ≥4.5:1- [ ] Focus order matches visual layout- [ ] Tested with VoiceOver/TalkBack- [ ] Accessibility labels use i18n (`t.feature.accessibility.key`)## Related Skills- `/design` - Touch targets, contrast (visual aspects)- `/testing` - Add accessibility tests with other tests- `/i18n` - Localize accessibility labels

Frequently asked questions