xcode-archive-release

Installation
SKILL.md

Xcode Archive & Release

Release an Apple app by bumping version/build metadata, archiving with Xcode, exporting and uploading to App Store Connect, then tagging the released HEAD in git.

Use when

  • The user wants to archive and upload an iOS or macOS app to App Store Connect
  • The user wants to release from an explicit version/build or infer them from a git tag
  • The user needs to retry an upload without rebuilding unless necessary

Prerequisites

  • macOS with Xcode and xcodebuild available
  • A signed Xcode project with a valid scheme
  • Access to the correct Apple Developer team and App Store Connect account
  • A clean understanding of the target project, scheme, platform list, version, and build number

The main helper is scripts/xcode-release.sh. The bundled assets/ExportOptions-AppStore.plist sets method=app-store and destination=upload, so the default flow uploads directly to App Store Connect without a separate altool step. After a successful automatic upload, the script creates the annotated git tag v<version>-<build> on the current HEAD and pushes that exact tag to the branch's upstream remote, or origin if no upstream remote is configured.

Related skills

More from grepug/skills

Installs
13
Repository
grepug/skills
First Seen
Mar 15, 2026