setup-ci-cd

What problem does it solve?

This Skill removes the manual, error-prone work of keeping Xcode project version numbers and build numbers in sync by configuring GitHub Actions to bump MARKETING_VERSION from conventional commits and configuring Xcode Cloud to set CURRENT_PROJECT_VERSION from its build counter.

Core Features & Use Cases

• Automated version bumps: Creates a GitHub Actions workflow that detects conventional commit types and updates MARKETING_VERSION across targets.
• Xcode Cloud build numbers: Adds a post-clone script to set CURRENT_PROJECT_VERSION from Xcode Cloud's CI_BUILD_NUMBER so every build has a unique, monotonic build number.
• Project hygiene and validation: Detects .xcodeproj, resolves multi-target mismatches, and enables Apple Generic versioning when needed.
• Use Case: When initializing CI for an iOS app, run this Skill to ensure semantic version bumps on pushes and reliable build numbering for TestFlight and App Store distribution.

Quick Start

Run the setup-ci-cd skill to detect and normalize your .xcodeproj versions, enable apple-generic versioning if needed, create a GitHub Actions auto-version workflow for conventional commits, and add a ci_post_clone script so Xcode Cloud sets the build number automatically.