xcode-test_skill

Overview

This skill builds, installs, and tests iOS apps on the simulator using XcodeBuildMCP. It automates building for simulator, launching the app, capturing screenshots and console logs, and guiding human verification when external flows are required. The output is a concise test summary with artifacts and suggested next steps.

How this skill works

The skill verifies XcodeBuildMCP availability, discovers Xcode projects and schemes, boots a simulator, builds the app for the simulator target, and installs and launches the app. It captures screenshots of key screens, streams simulator logs for error detection, and pauses for human verification on flows that require user interaction. Failures are documented with artifacts and options to fix now, create a todo, or skip.

When to use it

• Validate app UI and basic flows on an iOS Simulator
• Run smoke tests after code changes or a PR touching iOS code
• Capture reproducible artifacts for crashes and exceptions
• Verify simulator-only flows before running device labs
• Automate CI checks that require a simulator environment

Best practices

• Ensure Xcode and command-line tools are installed and XcodeBuildMCP is connected before running
• Prefer a stable simulator (e.g., iPhone 15 Pro) and confirm it boots fully before install
• Run with a named scheme or use "current" to reuse the default scheme
• Capture screenshots and logs for every failure to enable fast debugging
• Use human verification prompts for external flows like Sign in with Apple or push notifications

Example use cases

• Run a pre-merge smoke test to confirm a build installs and launches on simulator
• Reproduce a reported crash: build the same scheme, run, collect logs and screenshots, and create a P1 todo
• Validate UI changes across key screens by taking screenshots and checking layout and content
• Confirm sandbox in-app purchase or Sign in with Apple flows with a human verifier
• Automate nightly simulator tests to catch regressions early