skills.rest
surfingalien
surfingalienCOMMUNITY
Explore all skills by this author →
GitHub

ios-app-tester

Automate iOS Simulator UI testing and accessibility audits using the AXe CLI.

1|Updated May 6, 2026
Search Tags:#automation#accessibility#ios#ui testing#simulator#voiceover#axe
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill ios-app-tester-surfingalien
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ios-app-tester
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/ios-app-tester
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill ios-app-tester-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually testing iOS apps in the Simulator is slow and hard to repeat, and auditing accessibility labels or VoiceOver support screen by screen is tedious. This Skill provides scripted, repeatable control of the iOS Simulator through the AXe command-line tool. ## Core Features & Use Cases - UI Automation: Tap, swipe, scroll, type text, and press hardware buttons programmatically on any booted simulator via UDID. - Accessibility Auditing: Dump the full accessibility tree with describe-ui to find missing labels, hints, and incorrect traits for VoiceOver compliance. - Test Recording & CI Integration: Record MP4 videos of test runs and integrate scripted flows into GitHub Actions or other CI/CD pipelines. - Use Case: Automate a login flow by tapping the email field, typing credentials via stdin, tapping the login button, then verifying success by grepping the accessibility tree for a "Welcome" element. ## Quick Start Use the ios-app-tester skill to list my available simulators, tap the login button on the booted simulator, and dump the accessibility tree to verify the result.

Frequently Asked Questions about ios-app-tester

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

FAQPage Schema
How do I automate iOS Simulator UI testing from the command line?▼

Install AXe via Homebrew, get your simulator UDID with `axe list-simulators`, then run commands like `axe tap -x 200 -y 400 --udid <UDID>` to perform taps, swipes, and text input programmatically without any server setup.

How to audit iOS app accessibility labels and VoiceOver support?▼

Run `axe describe-ui --udid <UDID>` to dump the full accessibility tree of the current screen. Review the output for missing accessibilityLabel values, generic labels like "button", missing hints, and incorrect accessibilityTraits.

What are the requirements for running AXe iOS testing?▼

AXe requires macOS with Xcode installed, an iOS Simulator (bundled with Xcode), and Homebrew for installation via `brew tap cameroncooke/axe && brew install axe`. The simulator must be booted before running commands.

Can I record videos of iOS Simulator test runs?▼

Yes, use `axe record-video --udid <UDID> --fps 15 --output test.mp4` to record MP4 files, or stream via ffmpeg or MJPEG formats for live processing. Recording is useful for debugging failed CI test runs.

Why does AXe report simulator not found or commands not responding?▼

The simulator must be booted first with `xcrun simctl boot "iPhone 15"`, and you need the correct UDID from `axe list-simulators`. If commands don't respond, ensure the app is in the foreground and add `--post-delay` between commands.

How do I integrate iOS UI tests into a CI/CD pipeline?▼

Boot the simulator with xcrun simctl, install and launch your app, then run AXe automation scripts and accessibility audits as CI steps. The Skill includes a GitHub Actions example showing video recording alongside scripted test flows.

Related Skills

Explore More Software Engineering Skills→
robinsalehjanrobinsalehjan

ios-debugger-agent

Build, run, launch, and debug iOS projects on booted simulators with xcodebuild and xcrun simctl.

Community
Intermediate
sakhnenkoffsakhnenkoff
1

forge-ship

Automate App Store pre-flight audits for Forge apps across seven categories.

Community
Advanced
alekspetrovalekspetrov
196

frontend-test

Generate React and Vue component tests with React Testing Library.

Community
Intermediate
LambdaTestLambdaTest
350

appium-skill

Generate Appium mobile automation scripts for Android and iOS in Java, Python, or JavaScript.

Official
Advanced