IOS Simulator Skill

Features

• Automate Xcode builds and tests with progressive error disclosure
• Semantic UI navigation via accessibility APIs
• Simulator lifecycle management (boot, shutdown, create, delete, erase)
• Accessibility auditing and visual diffing for testing
• Status bar and clipboard manipulation for test control
• Token-efficient output and output formatting

Use Cases

• Automating CI/CD pipelines for iOS app builds and tests
• Programmatically controlling the iOS simulator for UI testing
• Capturing app state and logs for debugging
• Ensuring accessibility compliance in iOS applications
• Testing push notification handling and deep linking

Non-Goals

• Direct interaction with physical iOS devices
• Automating macOS application development outside of Xcode builds
• Providing general-purpose scripting capabilities not related to iOS simulation

Workflow

1. Verify environment using `sim_health_check.sh`
2. Launch app using `app_launcher.py`
3. Analyze current screen state with `screen_mapper.py`
4. Interact with UI elements using `navigator.py`
5. Perform accessibility audit with `accessibility_audit.py`
6. Capture state for debugging using `app_state_capture.py`

Practices

• Accessibility First
• Token Efficiency
• Semantic Navigation
• Zero Configuration
• Structured Data

Prerequisites

• macOS 12+
• Xcode Command Line Tools
• Python 3
• IDB (optional, for interactive features)
• Pillow (optional, for visual diffs)