Can this skill test apps on physical iOS devices?

This specific skill is optimized for iOS Simulator testing to ensure fast iteration and easy screenshot capture within the development environment.

What is XcodeBuildMCP and why is it required?

XcodeBuildMCP is a Model Context Protocol server that bridges Claude Code with Xcode's command-line tools, enabling the AI to control simulators and execute builds.

What happens when a test fails or a crash occurs?

The skill captures the relevant console logs and screenshots, notifies the user of the specific error, and offers to either fix the code immediately or create a pending P1 todo.

Do I need to have Xcode installed to use this?

Yes, you must have Xcode and its command-line tools installed, along with a configured iOS simulator on your macOS machine.

How does the skill handle interactive flows like Sign in with Apple?

It uses a Human Verification task that pauses the automation and prompts the user to complete the specific manual step before resuming the test.

Xcode Simulator Tester

Name: Xcode Simulator Tester
Author: udecode

byudecode

•

387

•

Mobile Development

Automates the building, installation, and end-to-end testing of iOS applications on simulators using XcodeBuildMCP.

The test-xcode skill streamlines iOS development by allowing Claude to manage the full testing lifecycle within the simulator environment. It automates complex workflows including project discovery, scheme selection, simulator booting, and app building. Beyond simple deployment, it performs visual regression checks via screenshots and monitors system logs for crashes or network errors. Designed for modern mobile workflows, it integrates human-in-the-loop verification for sensitive flows like Apple Sign-In and Push Notifications, ultimately providing a comprehensive test summary and auto-generated debugging tasks.

Key Features

01Automated iOS/macOS app building for simulator targets

02Comprehensive test reporting with auto-generated P1 debugging todos

03Interactive human verification for system-level authentication and permissions

04Visual UI verification through automated screenshot capture

05387 GitHub stars

06Real-time console log monitoring for crashes and exceptions

Use Cases

01Identifying and debugging application crashes during the launch or navigation phase

02Automating regression testing on iOS apps after significant code changes

03Verifying UI layout and rendering across different simulator device types

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add udecode/better-convex test-xcode

For use in Claude.ai and ChatGPT

Download Skill