verify-ios-build

Review uncommitted changes and run xcodebuild with simulator or device fallback.

8|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/ChoshimWy/iOSAgentSkills --skill verify-ios-build
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verify-ios-build
Source: https://github.com/ChoshimWy/iOSAgentSkills/tree/main/skills/verify-ios-build
Command: npx skills add https://github.com/ChoshimWy/iOSAgentSkills --skill verify-ios-build

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Apple Xcode projects often require a final quality gate to ensure changes don't break builds; this Skill provides a enforced final review before xcodebuild verification.

Core Features & Use Cases

  • Static review of uncommitted changes (git diff, etc.)
  • Run a final xcodebuild validation with simulator or device fallback according to repository config
  • Guidance on when to use alternative skills (code-review, xcode-build, ios-device-automation)

Quick Start

Run verify-ios-build from the repository root to perform the final gate before merging.

Frequently Asked Questions about verify-ios-build

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

FAQPage Schema
How do I validate uncommitted iOS changes before running xcodebuild?

To validate uncommitted iOS changes, this skill performs a preflight static review on your git diff to identify blockers before attempting an xcodebuild verification. It runs directly from the repository root as a final quality gate.

How does xcodebuild validation handle simulator fallback for iOS devices?

Xcodebuild validation uses a simulator-first build approach with an automatic fallback to a connected iOS device if available. This behavior is driven by the repository’s .codex/xcodebuild.env configuration and build-check tooling.

Do I need a specific configuration file to run an iOS build validation gate?

Yes, you need a .codex/xcodebuild.env configuration file to select the workspace, scheme, configuration, and destination. This file is required by the build-check tooling to ensure a safe gate before final approval.

When should I use a static review skill versus a standard xcodebuild command?

Use a static review skill when you need an enforced final review of uncommitted changes before merging, rather than just compiling code. It provides guidance on when alternative skills like code-review or xcode-build are more appropriate for your workflow.

What is the best way to report build blockers during iOS git diff static review?

The best way to report build blockers is to run this validation skill from the repository root, which performs the preflight static review and simulator or device build attempt, explicitly reporting any blockers encountered during the process.