ios-simulator-skill

Automate iOS simulator testing with xcrun simctl and idb.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/synqing/BT-HIL --skill ios-simulator-skill-synqing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-simulator-skill
Source: https://github.com/synqing/BT-HIL/tree/main/.claude/skills/ios-simulator-skill-main
Command: npx skills add https://github.com/synqing/BT-HIL --skill ios-simulator-skill-synqing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pillow, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates iOS simulator testing and automation workflows, reducing manual setup and repetitive tasks.

Core Features & Use Cases

  • Build, launch, and navigate iOS apps on simulators using semantic UI interactions and device lifecycle controls.
  • Accessibility auditing and testing to verify UI labels, hints, and proper traits across views.
  • Efficient, token-friendly outputs with JSON or concise text suitable for AI agents, plus detailed logs when needed.

Quick Start

  1. Check the environment: bash scripts/sim_health_check.sh
  2. Launch an app: python scripts/app_launcher.py --launch com.example.app
  3. Map the screen: python scripts/screen_mapper.py
  4. Tap a button: python scripts/navigator.py --find-text "Login" --tap
  5. Enter credentials: python scripts/navigator.py --find-type TextField --enter-text "[email protected]"

Frequently Asked Questions about ios-simulator-skill

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

FAQPage Schema
How do I automate iOS simulator testing for navigation and accessibility checks?

Automate iOS simulator testing by running Python scripts that use xcrun simctl and idb to manage device lifecycles, navigate semantic UI interactions, and perform accessibility auditing. The skill provides machine-friendly JSON output with strict error handling for repeatable automation.

How do I launch an app and map the screen on an iOS simulator using idb?

Launch an app on an iOS simulator and map the screen by executing `app_launcher.py` with the bundle identifier, then running `screen_mapper.py` to capture UI elements. This token-efficient workflow outputs concise JSON state and visual data suitable for AI agents.

Can I use xcrun simctl to automate text entry and button taps in an iOS app?

Yes, you can automate text entry and button taps by running the `navigator.py` script. It uses xcrun simctl and idb to find elements by text or type, such as TextField, enabling automated interactions like tapping a Login button or entering credentials.

What dependencies do I need to run iOS simulator automation scripts?

You need Python with the `pillow` library installed, plus external tooling including xcrun simctl and idb for simulator control. Run `sim_health_check.sh` first to verify your environment setup before launching automation workflows.

Does iOS simulator automation support accessibility auditing for UI labels and traits?

Yes, the skill supports accessibility auditing and testing to verify UI labels, hints, and proper traits across views. It automates these checks on the iOS simulator, providing reliable validation of accessibility compliance through structured JSON output.

Why is my iOS simulator automation not working after environment setup?

iOS simulator automation failures often stem from missing external tooling or incorrect environment configuration. Run `sim_health_check.sh` to diagnose issues, ensure xcrun simctl and idb are properly installed, and verify the `pillow` Python dependency is present before executing scripts.