Mobile Accessibility Reviewer

Use this skill to review mobile UI changes for screen-reader clarity, state communication, focus behavior, and accessible interaction patterns.

Workflow

1. Inspect the UI flow, not just individual components: entry point, loading, empty, error, disabled, success, modal, and navigation states.
2. Check labels, roles, hints, accessibilityState, accessibilityValue, hit targets, focus order, and announcements for dynamic changes.
3. Check whether custom controls behave like native controls for screen readers and keyboard/switch access where applicable.
4. Check contrast and text scaling against design tokens and platform accessibility expectations.
5. For UHC Mobile federated modules, prefer approved @uhg-uhc-mobile/accessibility utilities when the package provides the needed helper.
6. Report blocking accessibility defects first, then usability improvements and test gaps.

Review Focus

• Missing or misleading accessibilityLabel, accessibilityRole, accessibilityHint, accessibilityState, or accessibilityValue.
• Focus not moved or restored after modal, validation, navigation, loading, or async state changes.
• Dynamic updates not announced where screen-reader users need confirmation.
• Disabled, loading, empty, and error states that are visual-only.
• Custom touch targets that are too small or do not expose control semantics.
• Hard-coded colors or text sizing that bypass design tokens and scaling.

Output

• Lead with findings ordered by severity, with file and line references when possible.
• Separate blocking issues from high, medium, and low priority recommendations.
• Explain impact in mobile-user terms: security exposure, broken rollout, jank, inaccessible flow, analytics drift, build/runtime failure, or maintainability risk.
• Include specific remediation guidance. Keep code snippets small unless the user asks for an implementation.
• If no issues are found, say so clearly and note any meaningful test or verification gaps.

References

• references/review-guide.md: Migrated detailed review guide from the original mobile-ai-skills agent definition. Read it when you need the full checklist, example report shape, or grep patterns.