skills.rest
whinchman
whinchmanCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

mac-build-validator

Validates iOS and macOS builds by running xcodebuild over SSH on a remote Mac.

Updated May 2, 2026
Search Tags:#ssh#xcodebuild#build validation#rsync#cocoapods#ios build#remote mac
One-click install
npx skills add https://github.com/whinchman/midi-man-mk3 --skill mac-build-validator-whinchman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mac-build-validator
Source: https://github.com/whinchman/midi-man-mk3/tree/main/.claude/skills/mac-build-validator
Command: npx skills add https://github.com/whinchman/midi-man-mk3 --skill mac-build-validator-whinchman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Verifying that iOS/macOS code changes actually compile requires access to a Mac with Xcode, which developers on Linux or CI agents often lack. This Skill automates remote build validation so you get a clear pass/fail verdict without owning local Apple hardware. ## Core Features & Use Cases - Remote Build Execution: rsyncs your worktree to a remote Mac and runs xcodebuild, build scripts, or CocoaPods installs over SSH. - Automatic Project Detection: Identifies whether a repo uses a build script, Podfile, xcworkspace, or xcodeproj and picks the correct build command. - Structured Reporting: Writes a Markdown report with per-repo verdicts and the last 60 lines of failed build output. - Use Case: After completing a feature branch touching an iOS target, run this Skill to confirm the project compiles on the remote Mac before merging, and hand the failure logs back to the coordinator if it does not. ## Quick Start Validate the iOS build for the current feature by syncing my worktree to the remote Mac and running xcodebuild over SSH.

Frequently Asked Questions about mac-build-validator

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

FAQPage Schema
How do I validate an iOS build on a remote Mac over SSH?▼

Rsync your worktree to the remote Mac, then SSH in and run xcodebuild against the detected workspace or project. This Skill automates that flow, capturing the exit code and last 60 lines of output for the report.

How to run xcodebuild without a local macOS machine?▼

Use SSH to execute xcodebuild on a remote Mac build host. The Skill reads the mac_build.host and mac_build.workspace values from each iOS target's agent-build.yaml and runs all commands remotely, so no local Xcode is needed.

Does xcodebuild work with CocoaPods projects?▼

Yes, but you must run pod install first to generate the xcworkspace, then build that workspace with xcodebuild. The Skill detects a Podfile automatically and runs pod install before building, skipping the build if the install fails.

What happens if the remote Mac host is not configured?▼

If mac_build.host is empty or missing for a target, that target is recorded as SKIP while other targets still run. If every target is skipped, the Skill writes an overall SKIP report and stops.

Why does the build report only show the last 60 lines of output?▼

The Skill pipes xcodebuild output through tail -60 to keep reports focused on the actual failure, since xcodebuild errors typically appear at the end of the log. Full output remains available on the remote Mac during the session.

Related Skills

Explore More Software Engineering Skills→
JaimeJunrJaimeJunr
2

using-git-worktrees

Create and manage isolated Git worktrees for parallel branch development.

Community
Advanced
ByronWilliamsCPAByronWilliamsCPA

finishing-a-development-branch-extras

Resolve GitHub branch finishing failures with gh api fallback and release sequencing.

Official
Advanced
berkcangumusisikberkcangumusisik
11

test-mutation

Identify test mutations that existing test suites would not catch.

Community
Intermediate
AutisticAFAutisticAF
4

generators-ci-cd-setup

Generate CI/CD configuration templates for iOS/macOS apps using GitHub Actions, Xcode Cloud, or Fastlane.

Community
Advanced