ce-test-xcode

Builds, installs, and tests iOS apps on simulators using XcodeBuildMCP.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/Norfolk-Group/marcela-norfolk-ai --skill ce-test-xcode-norfolk-group
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ce-test-xcode
Source: https://github.com/Norfolk-Group/marcela-norfolk-ai/tree/main/skills/compound-engineering/skills/ce-test-xcode
Command: npx skills add https://github.com/Norfolk-Group/marcela-norfolk-ai --skill ce-test-xcode-norfolk-group

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Verifying iOS code changes manually requires repetitive build, install, launch, and screenshot cycles on a simulator, which slows down pre-PR validation and lets crashes slip through. ## Core Features & Use Cases - Automated Simulator Testing: Discovers projects and schemes, boots a simulator, builds the app, installs it, and launches it via XcodeBuildMCP. - Screenshot and Log Verification: Captures screenshots of key screens and inspects simulator logs for crashes, exceptions, and failed network requests. - Human Verification Handoffs: Pauses for manual confirmation on flows automation cannot handle, such as Sign in with Apple, push notifications, and SwiftUI inline text links. - Use Case: After modifying an iOS feature, run the skill with a scheme name to rebuild the app, walk through key screens, and receive a structured pass/fail test summary before opening a PR. ## Quick Start Ask the agent to run the ce-test-xcode skill with your scheme name to build and test the app on an iOS simulator.

Frequently Asked Questions about ce-test-xcode

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

FAQPage Schema
How do I test an iOS app on a simulator automatically?

Use XcodeBuildMCP to discover the project, list schemes, boot a simulator, build the app, then install and launch it. The skill captures screenshots of key screens and checks simulator logs for crashes and errors.

How do I install XcodeBuildMCP for simulator testing?

Install via Homebrew with brew tap getsentry/xcodebuildmcp && brew install xcodebuildmcp, or run it without a global install using npx -y xcodebuildmcp@latest mcp. Then add XcodeBuildMCP as an MCP server in your agent configuration and restart.

Why do automated taps not work on SwiftUI Text links?

Simulated taps do not trigger gesture recognizers on SwiftUI Text views with inline AttributedString links because those links are not exposed as separate accessibility elements. Tap manually in the simulator or use xcrun simctl openurl with the target URL as a fallback.

Can simulator automation test Sign in with Apple or push notifications?

No, flows like Sign in with Apple, push notifications, in-app purchases, camera, and location require human interaction. The skill pauses and asks the user to complete these steps manually on the simulator before continuing.

What happens when an iOS simulator test fails?

The skill documents the failure with a screenshot, console logs, and reproduction steps, then asks whether to fix now or skip. Choosing fix triggers debugging, a proposed fix, a rebuild, and a retest; skipping logs the failure and continues.