se-test-xcode

Automate building, installing, and testing iOS apps on simulators via XcodeBuildMCP.

Updated May 7, 2026
One-click install
npx skills add https://github.com/simonwjackson/pi-software-engineering --skill se-test-xcode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: se-test-xcode
Source: https://github.com/simonwjackson/pi-software-engineering/tree/main/skills/se-test-xcode
Command: npx skills add https://github.com/simonwjackson/pi-software-engineering --skill se-test-xcode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Build and test iOS apps on a simulator by orchestrating XcodeBuildMCP to perform end-to-end validation of changes. It provides a reliable workflow to verify builds, test flows, and crash behavior across simulators.

Core Features & Use Cases

  • Discover available iOS projects and schemes, boot a target simulator, build the app, install and launch it, and capture logs for test automation.
  • Verify app behavior across selected schemes and simulators, enabling automated UI checks and crash detection in CI or local development.
  • Use in PR workflows to ensure changes meet quality gates before merging.

Quick Start

Run the skill with a specific scheme or 'current' to test your iOS app on the available simulator.

Frequently Asked Questions about se-test-xcode

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate building and testing an iOS app on a simulator?

Automated iOS simulator testing orchestrates XcodeBuildMCP to discover projects, boot a simulator, build the app, install it, and capture logs to verify behavior and detect crashes across supported schemes.

How does automated simulator testing capture logs for UI checks?

Automated simulator testing captures logs by booting a target simulator, installing and launching the app, and reading the output to verify key screens and identify crash behavior during the test flow.

Do I need an XcodeBuildMCP server to run iOS simulator tests?

Yes, a connected XcodeBuildMCP server is required. You also need Xcode with CLI tools, a valid Xcode project or workspace, and at least one available iOS Simulator to execute the automated tests.

Can I use automated iOS testing to validate changes in PR workflows?

Yes, you can use automated iOS simulator testing in PR workflows to ensure changes meet quality gates before merging by verifying builds, testing flows, and checking crash behavior across simulators.

What's the best way to verify app behavior across multiple iOS schemes?

To verify app behavior across multiple iOS schemes, use an automation workflow that discovers available schemes, boots the target simulator, builds the app, and launches it to test key screens and capture logs.

Why is my iOS simulator test not detecting the correct Xcode project?

If your iOS simulator test is not detecting the project, ensure you have a valid Xcode project or workspace in the directory and provide a specific scheme name, or use 'current' to target the default scheme.