ios-simulator-skill

Automate iOS simulator testing and UI navigation using semantic accessibility data.

1.2k|84|Updated Oct 17, 2025
One-click install
npx skills add https://github.com/conorluddy/ios-simulator-skill --skill ios-simulator-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-simulator-skill
Source: https://github.com/conorluddy/ios-simulator-skill/tree/main/skill
Command: npx skills add https://github.com/conorluddy/ios-simulator-skill --skill ios-simulator-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

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

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

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 app testing without using pixel coordinates?

Accessibility-first automation uses semantic elements like buttons and text fields instead of fragile pixel coordinates. This Skill provides scripts to interact with iOS apps through their accessibility data, making tests more robust and adaptable to UI changes while reducing token overhead for AI agents.

Can I automate a complete iOS login flow including form filling and button taps?

Yes. Launch your app with app_launcher.py, map the screen with screen_mapper.py to identify elements semantically, then use navigator.py to fill text fields and tap buttons like Login by referencing their labels rather than positions, all with minimal output.

What's the best way to audit iOS app accessibility during automated testing?

This Skill includes accessibility audit scripts that run alongside your test suite to capture semantic element data, screen state, and compliance issues. Combined with visual diffing and full app state capture, you get comprehensive QA reports without manual inspection.

Do I need Xcode and an iOS simulator set up before using this automation?

Yes. Verify your environment with sim_health_check.sh first. The Skill automates Xcode builds, test runs, and simulator interaction, but requires an existing iOS development setup with working Xcode and simulator infrastructure.

How does token-efficient iOS automation differ from traditional testing tools?

Traditional tools output verbose logs and pixel-based coordinates that waste AI tokens. This Skill uses progressive disclosure—returning only essential semantic data, structured JSON outputs, and actionable errors—so AI agents spend tokens on logic, not parsing noise.

Can I use this for both building Xcode projects and running test suites?

Yes. The Skill automates Xcode project builds with minimal output, runs test suites, parses XCResult data, and manages simulator lifecycle. It handles build errors and warnings with progressive disclosure so you see only what matters for debugging.