Appstore archive uploader

Skill Xopoko/build-swift-apps/skills/appstore-archive-uploader

Manage Xcode version/build numbers, archive, export, upload, and publish IPA/PKG artifacts with `asc xcode` helpers before TestFlight or App Store submission.From its SKILL.md

Install

npx -y skills add Xopoko/build-swift-apps --skill appstore-archive-uploader

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

runs commandsInstructs the agent to run 8 commands, including `asc xcode version view` and 7 more.

SKILL.md

3.1 KB, 790 tokens by cl100k_base, as published. Nobody here has run it

App Store Archive Uploader

Prefer asc xcode archive and asc xcode export over raw xcodebuild when they fit.

Preconditions

Xcode/CLT installed; signing identity/profiles or automatic signing available; ASC auth configured for upload/build lookup.

Version And Build

asc xcode version view
asc xcode version edit --version "1.3.0" --build-number "42"
asc xcode version bump --type build
asc xcode version bump --type patch
asc builds next-build-number --app "APP_ID" --version "1.2.3" --platform IOS --output json
asc xcode version edit --build-number "NEXT_BUILD"

Use --project-dir, --project, and --target for multi-project/target determinism.

iOS/tvOS/visionOS

asc xcode archive --workspace "App.xcworkspace" --scheme "App" --configuration Release \
  --clean --archive-path ".asc/artifacts/App.xcarchive" \
  --xcodebuild-flag=-destination --xcodebuild-flag=generic/platform=iOS --output json

asc xcode export --archive-path ".asc/artifacts/App.xcarchive" \
  --export-options "ExportOptions.plist" --ipa-path ".asc/artifacts/App.ipa" \
  --xcodebuild-flag=-allowProvisioningUpdates --output json

Use --project "App.xcodeproj" for project-only apps. Add --wait to export/upload/publish when the next step depends on processed builds.

Upload/distribute:

asc builds upload --app "APP_ID" --ipa ".asc/artifacts/App.ipa" --wait
asc publish testflight --app "APP_ID" --ipa ".asc/artifacts/App.ipa" --group "GROUP_ID" --wait
asc publish appstore --app "APP_ID" --ipa ".asc/artifacts/App.ipa" --version "1.2.3" --wait
asc publish appstore --app "APP_ID" --ipa ".asc/artifacts/App.ipa" --version "1.2.3" --wait --submit --confirm

macOS App Store

asc xcode archive --project "MacApp.xcodeproj" --scheme "MacApp" --configuration Release \
  --clean --archive-path ".asc/artifacts/MacApp.xcarchive" \
  --xcodebuild-flag=-destination --xcodebuild-flag=generic/platform=macOS --output json

xcodebuild -exportArchive -archivePath ".asc/artifacts/MacApp.xcarchive" \
  -exportPath ".asc/artifacts/MacAppExport" -exportOptionsPlist "ExportOptions.plist" \
  -allowProvisioningUpdates

asc builds upload --app "APP_ID" --pkg ".asc/artifacts/MacAppExport/MacApp.pkg" \
  --version "1.0.0" --build-number "123" --wait

PKG uploads require explicit --version and --build-number.

Fallback And Troubleshooting

Use raw xcodebuild only when asc xcode archive/export --help cannot cover an option; try --xcodebuild-flag first.
No profiles: add --xcodebuild-flag=-allowProvisioningUpdates, verify Xcode account/profiles, or use appstore-signing-setup.
Build number too low: resolve asc builds next-build-number, edit, rebuild, upload.
Missing macOS icon: fix ICNS/asset catalog sizes, rebuild, export/upload.
Use --overwrite only when intentionally replacing local artifacts.
For submission readiness, use appstore-review-readiness.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.