ios-simulator-skill

What problem does it solve?

Traditional iOS automation tools are often token-inefficient, fragile due to pixel-based navigation, and complex for AI agents to use effectively. This Skill solves these problems by providing a suite of 12 production-ready scripts that offer ultra token-efficient, accessibility-first automation for building, testing, and navigating iOS applications, making AI-driven mobile development robust and cost-effective.

Core Features & Use Cases

• Token-Efficient Build & Test: Automate Xcode project builds and run test suites with minimal output, saving valuable AI tokens and providing progressive disclosure of errors/warnings.
• Accessibility-First UI Navigation: Interact with iOS apps using semantic elements (buttons, text fields) rather than fragile pixel coordinates, ensuring robust and adaptable automation.
• Comprehensive Testing Suite: Perform accessibility audits, visual regression testing, and full app state capture for thorough debugging and quality assurance.
• Use Case: Automate a complete login flow in your iOS app, from launching the application and filling credentials to tapping the login button and verifying the home screen, then audit the screen for accessibility issues – all with minimal, actionable AI interaction.

Quick Start

1. Verify your iOS development environment is set up correctly

bash scripts/sim_health_check.sh

2. Launch your iOS app (replace 'com.example.app' with your app's bundle ID)

python scripts/app_launcher.py --launch com.example.app

3. Get a quick, token-efficient summary of what's on the current screen

python scripts/screen_mapper.py

4. Tap a button using semantic navigation (e.g., the "Login" button)

python scripts/navigator.py --find-text "Login" --tap