skills.rest
mmnavarr
mmnavarrCOMMUNITY
Explore all skills by this author →
Website𝕏@mxlcolmGitHub

test-xcode

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

Updated May 11, 2026
Search Tags:#automation#testing#build#ios#xcode#simulator#xcodebuildmcp
One-click install
npx skills add https://github.com/mmnavarr/harness --skill test-xcode-mmnavarr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: test-xcode
Source: https://github.com/mmnavarr/harness/tree/main/skills/test-xcode
Command: npx skills add https://github.com/mmnavarr/harness --skill test-xcode-mmnavarr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Verifying iOS code changes manually requires repeatedly building, launching a simulator, tapping through screens, and reading logs by hand. This Skill automates that loop so you can confirm an app builds, launches, and behaves correctly before opening a PR. ## 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 error-level messages. - Failure Handling and Human Checkpoints: Documents failures with screenshots and logs, offers fix/todo/skip options, and pauses for human verification on flows like Sign in with Apple, push notifications, and in-app purchases. - Use Case: After modifying an iOS feature, run the skill with your scheme name to build on an iPhone simulator, walk through key screens, and receive a pass/fail summary with any crashes and created todos. ## Quick Start Ask the agent to run the test-xcode skill with your scheme name to build and test the app on a simulator.

Frequently Asked Questions about 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?▼

Run the skill with a scheme name or 'current' to use the default scheme. It discovers the project, boots a simulator, builds and installs the app, captures screenshots of key screens, and checks logs for crashes and errors.

What is XcodeBuildMCP and how do I install it?▼

XcodeBuildMCP is an MCP server that exposes Xcode build and simulator controls as tools. Install it via Homebrew with brew tap getsentry/xcodebuildmcp && brew install xcodebuildmcp, or run it with npx -y xcodebuildmcp@latest mcp, then add it as an MCP server.

Can automated taps interact with SwiftUI Text links?▼

No. Simulated taps do not trigger gesture recognizers on SwiftUI Text views with inline AttributedString links because they are not exposed in the accessibility tree. The skill prompts for a manual tap or uses xcrun simctl openurl as a fallback.

What happens when an iOS build or test fails?▼

Build errors are captured and reported with specific details. Test failures are documented with screenshots and logs, and you choose to fix immediately, create a p1 todo via the todo-create skill, or skip and continue testing other screens.

Does simulator testing handle Sign in with Apple or push notifications?▼

These flows require human verification. The skill pauses and asks you to complete the action on the simulator, such as finishing Sign in with Apple or confirming a test push notification appears, before continuing.

Related Skills

Explore More Software Engineering Skills→
mattjeffersonmattjefferson

xcode-test

Build and test iOS apps on simulators via XcodeBuildMCP.

Community
Intermediate
subiniumsubinium
50

fight-repo-rot

Diagnose and prioritize codebase rot with confidence-tagged findings.

Community
Advanced
Devsoul2026Devsoul2026
150

requesting-code-review

Automate pre-commit verification with static analysis, tests, and lint checks.

Community
Advanced
SwiftedMindSwiftedMind
116

flowdeck

Manage Apple platform development tasks through a unified command-line interface.

Community
Advanced