iOS Simulator Automation Skill

29 production scripts that let Claude Code build, drive and audit iOS apps on the Simulator without pixel coordinates.

Dev & CodingIntermediate★ 1,258⑂ 93AI score 8/10Last updated: Sep 13, 2026

What it does

Semantic UI navigation: reads the accessibility tree instead of screenshots, so you tap by label/type/ID (navigator.py --find-text "Login" --tap).
Build & test: build_and_test.py builds Xcode schemes, runs tests and parses errors from xcresult bundles with progressive disclosure.
Device state control: dark mode, Dynamic Type, locale/region, GPS coordinates and GPX routes, status bar presets, push notifications, and permission grant/revoke for 13 services.
Quality checks: WCAG accessibility audits, screenshot visual diffs, .xcstrings localization gap detection, and hang-event capture with clustered summaries.
Simulator lifecycle: boot, shutdown, create, delete, erase, plus smart device suggestion for CI.
Token-aware output: 3–5 line defaults with --verbose, --json and cached detail lookups.

Who it's for

iOS developers on Xcode who burn time on repetitive manual QA.
Teams that want automated accessibility and localization regression checks.
CI engineers who spin up simulators on demand and tear them down afterwards.

Examples

"Log in with this test account and tell me what happens" → screen_mapper.py, then navigator.py --find-type TextField --enter-text ... and --find-text "Login" --tap.
"Audit this screen for accessibility issues" → accessibility_audit.py reports unlabeled buttons and undersized touch targets.
"The app stutters while scrolling" → hang_watcher.py --start, interact, then --stop for a compact hang cluster summary.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/conorluddy/ios-simulator-skill/HEAD/ios-simulator-skill/skills/ios-simulator-skill/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)

Download the ZIP with the button below.
In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.

↓ Download ZIP

Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the ios-simulator-skill/skills/ios-simulator-skill folder from the GitHub repo conorluddy/ios-simulator-skill into my ~/.claude/skills/ios-simulator-skill/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/conorluddy/ios-simulator-skill.git && mkdir -p ~/.claude/skills && cp -r ios-simulator-skill/skills/ios-simulator-skill ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

Check prerequisites: macOS 15 (Sequoia) or newer, Xcode 26+ with Command Line Tools, Python 3.12+.

Install idb (required for every tap/swipe/type script):

brew tap facebook/fb && brew install facebook/fb/idb-companion facebook/fb/idb-cli

Optional: for visual diffs, run pip3 install pillow.

Install the skill with one command:

git clone https://github.com/conorluddy/ios-simulator-skill.git && mkdir -p ~/.claude/skills && cp -r ios-simulator-skill/skills/ios-simulator-skill ~/.claude/skills/

Verify the environment: bash ~/.claude/skills/ios-simulator-skill/scripts/sim_health_check.sh (add --json for structured output).
Boot a simulator from Xcode or headlessly with xcrun simctl boot <UDID>.
Restart Claude Code, then ask something like "launch my app on the simulator and map the screen" to trigger the skill.

View source on GitHub ↗License: MIT