skills.rest
CharlesWiltgen
CharlesWiltgenCOMMUNITY
Explore all skills by this author →
GitHub

accessibility-diag

Diagnose accessibility issues in iOS/macOS apps with WCAG-aligned checks.

1.1k|81|Updated Nov 30, 2025
Search Tags:#ui#accessibility#a11y#ios#wcag#app store#voiceover#dynamic type
One-click install
npx skills add https://github.com/CharlesWiltgen/Axiom --skill accessibility-diag
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: accessibility-diag
Source: https://github.com/CharlesWiltgen/Axiom/tree/main/plugins/axiom/skills/accessibility-diag
Command: npx skills add https://github.com/CharlesWiltgen/Axiom --skill accessibility-diag

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers systematically diagnose and remediate common accessibility issues that lead to App Store rejections, poor user experience for individuals with disabilities, and potential legal compliance risks.

Core Features & Use Cases

  • 7 Critical Issues: Comprehensive diagnosis and remediation for VoiceOver labels, Dynamic Type, color contrast, touch targets, keyboard navigation, and Reduce Motion support.
  • Accessibility Inspector Workflow: Step-by-step guide for using Xcode's built-in Accessibility Inspector to audit and fix UI elements.
  • App Store Review Preparation: Guidance on required accessibility features, metadata, and common rejection reasons to ensure smooth app submission.
  • Use Case: When preparing for App Store Review, use this skill to audit your app for Dynamic Type support, ensuring all text scales correctly and layouts adapt without clipping, preventing common rejections.

Quick Start

To test Dynamic Type, go to Settings > Accessibility > Display & Text Size > Larger Text on a simulator or device, then drag the slider to maximum and check your app's layout.

Frequently Asked Questions about accessibility-diag

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prepare my iOS app for App Store Review accessibility requirements?▼

App Store Review requires WCAG compliance across VoiceOver labels, Dynamic Type scaling, color contrast, touch targets, and keyboard navigation. This Skill diagnoses those 7 critical issues, provides remediation code samples, and outlines submission workflows to prevent rejections and ensure accessibility for users with disabilities.

What does VoiceOver support mean for iOS apps, and how do I implement it?▼

VoiceOver is Apple's screen reader for users with vision disabilities. Implementation requires adding descriptive labels and hints to UI elements so VoiceOver users can navigate and understand your app. This Skill guides you through Xcode's Accessibility Inspector to audit and fix VoiceOver gaps systematically.

How do I test Dynamic Type support in my iOS app?▼

Dynamic Type lets users scale text across your app without clipping or layout breakage. Test by enabling Larger Text in Settings > Accessibility > Display & Text Size on a simulator or device, then dragging the slider to maximum. This Skill covers Dynamic Type diagnosis and remediation to prevent App Store rejection.

What accessibility checks does Xcode's Accessibility Inspector perform?▼

The Accessibility Inspector audits VoiceOver labels, color contrast ratios, touch target sizes, and keyboard navigation in live apps. This Skill provides step-by-step workflows using the inspector to identify accessibility issues, output actionable guidance, and validate WCAG compliance before submission.

Why does my app fail accessibility testing for color contrast and touch targets?▼

Color contrast failures occur when text or interactive elements don't meet WCAG standards; touch target failures happen when buttons or controls are too small. This Skill diagnoses both issues, explains WCAG thresholds, and provides code samples to remediate contrast and sizing problems in iOS/macOS apps.

How do I support Reduce Motion for users with vestibular disorders in iOS?▼

Reduce Motion disables animations for users sensitive to motion. Implementing it requires checking UIAccessibility.isReduceMotionEnabled and removing animations or providing static alternatives. This Skill covers Reduce Motion diagnosis and remediation as part of WCAG compliance for App Store readiness.

Related Skills

Explore More Software Engineering Skills→
ckorhonenckorhonen
12

ios-app-tester

Run AXe-based accessibility audits and automate UI interactions on iOS Simulators.

Community
Intermediate
exiaoexiao
37

submission-health

Validates and prepares App Store submission packages per Apple's guidelines.

Community
Advanced
xtonextone
3

swiftui-accessibility

Add VoiceOver labels, hints, and values to SwiftUI views.

Official
Basic
cuellarfrcuellarfr
47

Accessibility Audit

Identify and report WCAG 2.2 conformance issues across pages, components, and flows.

Community
Advanced