xcode-macos-toolchain

What problem does it solve?

Configuring xcodebuild for macOS app distribution is complex and error-prone, with common failures including signing mismatches, incorrect destination syntax, failed notarization, and broken CI/CD pipelines that block app releases.

Core Features & Use Cases

• End-to-End Distribution Workflows: Covers building, archiving, exporting, notarizing, and stapling for native macOS, Mac Catalyst, and universal binary apps across Developer ID, Mac App Store, and development distribution channels.
• CI/CD Pipeline Templates: Includes production-ready GitHub Actions and Makefile examples for automated release pipelines, test matrices, and secure notarization credential management.
• Troubleshooting & Validation: Provides a review checklist and targeted fixes for common xcodebuild failures, signing errors, notarization issues, and architecture mismatches. Use case example: A macOS developer can use this skill to configure a CI pipeline that builds a universal binary, signs it with a Developer ID certificate, submits it for notarization, and staples the ticket automatically on every tagged release.

Quick Start

Use the xcode-macos-toolchain skill to configure a GitHub Actions workflow that automatically builds, notarizes, and staples a release-ready macOS app for direct distribution outside the Mac App Store.