ios-test

iOS Test Skill

Overview

Use this skill to build an iOS/SwiftUI application, launch it in the Simulator, and visually test it using computer use. The skill navigates through every screen, screenshots each state, checks crash logs, and produces a structured test report — without writing a single line of test code.

Options

• --flow=<name>: Test a specific user flow (e.g., onboarding, login, checkout)
• --screen=<ViewName>: Test only a specific screen
• --device=<name>: Choose a Simulator device (e.g., "iPhone 16", "iPhone SE")
• --scheme=<name>: Specify the Xcode scheme
• --states: Test empty, error, and loading states via launch arguments
• --screenshot-all: Screenshot every step
• --performance: Measure RAM per screen and check for memory leaks (skipped by default)

Workflow

1) Project Discovery

• Find .xcodeproj or .xcworkspace in the working directory
  • Prefer .xcworkspace if it exists (CocoaPods/SPM workspace)
  • If multiple exist, ask the user which one to use
  • If none found, stop with an error
• List available schemes:

  xcodebuild -list -workspace MyApp.xcworkspace
  

  • Use --scheme if provided
  • If only one scheme exists, use it automatically
  • If multiple, ask the user

2) Simulator Selection (BEFORE build)

IMPORTANT: Simulator must be selected BEFORE building. The build command uses the selected device name.

• If --device is provided: find that device via xcrun simctl list devices --json
• If --device is not provided, check booted simulators:

  xcrun simctl list devices booted --json
  

  • No booted simulator: list available devices with xcrun simctl list devices available --json, suggest the best iPhone match, ask for confirmation, then boot it
  • One booted simulator: use it directly, no questions
  • Multiple booted: list them and ask the user which one to use

3) Accessibility Check (MANDATORY — DO NOT SKIP)

This step is MANDATORY. Runs BEFORE build. NEVER skip this step.