ios-simulator · tristanmanchester — Claude Code skill for simulator testing
Run an app in iOS Simulator, inspect its accessible UI, and capture evidence. Use this skill for simulator-based testing or automation.
no license 103 installs ★ 4 updated 2026-09-14
npx skills add tristanmanchester/agent-skills --skill ios-simulator -a claude-codeWhat ios-simulator does
The skill guides an agent through selecting a specific simulator, installing and opening an app, inspecting the current screen, and saving a screenshot. It uses xcrun simctl for simulator and app operations, with idb for accessibility-driven interaction. After an action, the agent checks whether the expected UI state appeared; a tap alone does not count as a passing test.
Local use depends on macOS, full Xcode, and an installed simulator runtime. An optional command runner needs Node.js 22+. Current idb companion binaries target arm64 Macs running macOS 15 with Xcode 26, so those host requirements can block local setup. Simulator results do not establish physical-device behavior or App Store readiness.
What it helps with
- select a simulator by its exact UDID
- install and launch an
.appin the simulator - inspect UI elements through accessibility
- save a screenshot as test evidence
- diagnose a simulator launch failure
Example prompts for the agent
- Test the app in iOS Simulator, choose the intended UDID, and save a screenshot.
- Find the sign-in field through accessibility, enter a test value, and check the resulting screen.
- Investigate why the app fails to launch in the simulator and summarize the relevant logs.
How to install ios-simulator
1Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill ios-simulator -a claude-code2Manually: put the files in place
~/.claude/skills/ios-simulator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ios-simulator/
1Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill ios-simulator -a codex2Manually: put the files in place
.agents/skills/ios-simulator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill ios-simulator -a cursor2Manually: put the files in place
.cursor/skills/ios-simulator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install tristanmanchester/agent-skills ios-simulator2Manually: put the files in place
.github/skills/ios-simulator/SKILL.md1Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill ios-simulator -a gemini-cli2Platform CLI
gemini skills install https://github.com/tristanmanchester/agent-skills --path ios-simulatorManually: put the files in place
.devin/skills/ios-simulator/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add tristanmanchester/agent-skills --skill ios-simulator -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ios-simulator
How do I install ios-simulator in Claude Code?
Run npx skills add tristanmanchester/agent-skills --skill ios-simulator -a claude-code. The skill file is placed at ~/.claude/skills/ios-simulator/SKILL.md.
What does ios-simulator do?
It guides simulator control with xcrun simctl and accessibility-based UI interaction with idb, then checks outcomes and captures evidence.
What does local setup require?
Local use requires macOS, full Xcode, and a simulator runtime. The current companion binaries also target arm64, macOS 15, and Xcode 26.
Similar skills
All skills for Testing and QA →ios-simulator by other authors comes first.