test-xcode_skill

Overview

This skill builds, installs, and tests iOS apps on simulators using XcodeBuildMCP. It automates simulator boot, app build, installation, screenshot capture, and console log collection while supporting human verification for external flows.

How this skill works

The skill calls XcodeBuildMCP endpoints to discover projects and schemes, boot a chosen simulator, build the app for the simulator, install and launch the app, and capture screenshots and logs for key screens. When flows require user interaction (Sign in with Apple, push notifications, purchases, camera, location) it pauses and asks for human verification before proceeding.

When to use it

• Run smoke and acceptance tests on an iOS simulator after code changes.
• Validate UI rendering and basic flows on a CI-connected macOS agent.
• Capture reproducible logs and screenshots for bug reports.
• Verify changes in pull requests that touch iOS or UI code.
• Perform manual verification steps that require user input or external services.

Best practices

• Confirm XcodeBuildMCP is installed and responsive before starting.
• Use a stable, recommended simulator (e.g., iPhone 15 Pro) and ensure it is booted fully.
• Provide explicit project_path and scheme when multiple targets exist.
• Capture both screenshots and simulator console logs for every failure.
• Pause only for necessary human verification; document exact actions to perform.

Example use cases

• Run /xcode-test on a feature branch to validate UI after a refactor.
• Trigger from a PR review to produce a test summary with screenshots and errors.
• Reproduce a reported crash by building the same scheme and capturing logs.
• Create prioritized todos automatically for build errors or repeated failures.
• Perform a manual sign-in or in-app purchase verification on the simulator.