agentsclimarketplace

Asc release flow

Skill rorkai/app-store-connect-cli-skills/skills/asc-release-flow

Orchestrate App Store releases with asc, including staging a version, uploading or building an artifact, publishing, and submitting for review. Use when the user wants to prepare or execute a release. Keep Game Center item preparation in this skill; route other readiness failures, stuck submissions, cancellation, and retry decisions to asc-submission-health.From its SKILL.md

Install
npx -y skills add rorkai/app-store-connect-cli-skills --skill asc-release-flow

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

SKILL.md

7.3 KB, as published. Nobody here has run it

App Store release orchestration

Use this skill to carry a release from an approved plan to App Store review. Keep Game Center item preparation here; keep other blocker diagnosis and review recovery in asc-submission-health.

Ownership boundary

This skill owns:

  • staging metadata and attaching a build;
  • publishing an IPA or building locally;
  • submitting a prepared version;
  • assembling a multi-item review submission.

Use the preparation section for Game Center item preparation or attachment blockers. Use that reference's assembly and submission sections only after the app version is staged and the multi-item lane is selected. Stop and use asc-submission-health for other validation blockers, a stuck submission, cancellation, or retry decisions.

Preconditions

  • Resolve APP_ID, the version string, VERSION_ID when needed, and BUILD_ID when a build already exists.
  • Configure auth with asc auth login or ASC_* environment variables.
  • Confirm the intended platform. Use IOS unless the app targets another platform.
  • Keep canonical metadata in ./metadata when the workflow applies metadata.
  • Require a dry run before a mutating high-level command, then require --confirm for submission.

Choose the release lane

IntentCommand
Prepare metadata and attach an existing build without submittingasc release stage
Submit an already prepared versionasc review submit
Upload an IPA or build locally, then optionally submitasc publish appstore
Submit the app version with IAP, subscription, or Game Center version itemslower-level asc review submission commands

Do not mix lanes after one has already created a review submission. Inspect the existing submission first and continue through the matching lower-level commands.

Run the readiness gate

Apply this gate to a version that already has the intended build attached. For the staging lane, first complete Stage an existing build; asc release stage attaches the build and runs validation, after which this gate can be evaluated. Do not route an expected pre-staging "build not attached" result to asc-submission-health.

Validate before any submission:

asc validate --app "APP_ID" --version "1.2.3" --platform IOS --output table

Use strict mode when warnings must stop automation:

asc validate --app "APP_ID" --version "1.2.3" --platform IOS --strict --output table

Digital goods are a hard gate. If the release includes IAPs or subscriptions, stop and run the relevant product checks in asc-submission-health. Resume this flow only after those checks have no blocking issues and the intended product versions are prepared.

For Game Center items, complete only Prepare every item, then return to this flow. Do not assemble or submit the multi-item review submission during readiness.

If app validation reports a Game Center item blocker, stop and use that preparation section. If the only blocker is an unattached build in the staging lane, continue to the staging section. For every other blocker, stop the release flow and use asc-submission-health. Do not bury unrelated remediation inside the release run.

Stage an existing build

Use asc release stage to verify the selected build belongs to the app before changing the version, apply or copy metadata, attach the build, and run validation without creating a review submission.

Preview metadata-driven staging:

asc release stage \
  --app "APP_ID" \
  --version "1.2.3" \
  --build "BUILD_ID" \
  --metadata-dir "./metadata/version/1.2.3" \
  --dry-run \
  --output table

Apply the reviewed plan:

asc release stage \
  --app "APP_ID" \
  --version "1.2.3" \
  --build "BUILD_ID" \
  --metadata-dir "./metadata/version/1.2.3" \
  --confirm

Use --copy-metadata-from "1.2.2" instead of --metadata-dir when carrying localization metadata forward. Add --strict-validate when warnings should fail the stage.

If the metadata plan contains deletes, the dry run and confirmed run both require --allow-deletes. Review those deletes first; the flag also disables fallback to an existing locale when that locale is absent locally.

Use --routing-coverage-file "./coverage.geojson" when the release includes routing app coverage. This experimental step validates the GeoJSON before mutation and stages it before readiness checks.

Structured output includes a validate_build step at the start of steps[]. Match steps by name rather than array position.

Submit a prepared version

Use asc review submit after metadata, review details, availability, build processing, and product readiness are already resolved.

asc review submit --app "APP_ID" --version "1.2.3" --build "BUILD_ID" --dry-run --output table
asc review submit --app "APP_ID" --version "1.2.3" --build "BUILD_ID" --confirm

Use --version-id "VERSION_ID" instead of --version when the exact version ID is known. --build may be omitted only when the intended build is already attached and verified.

Upload or build, then publish

Use asc publish appstore when the release starts from an IPA or a local Xcode project/workspace.

Preview an IPA upload and submission:

asc publish appstore \
  --app "APP_ID" \
  --ipa "./App.ipa" \
  --version "1.2.3" \
  --submit \
  --dry-run \
  --output table

Run it after reviewing the plan:

asc publish appstore \
  --app "APP_ID" \
  --ipa "./App.ipa" \
  --version "1.2.3" \
  --submit \
  --wait \
  --confirm

For local-build mode, provide --workspace or --project with --scheme instead of --ipa. Use --metadata-dir when the publish command should apply canonical version metadata after ensuring the version.

Omit --submit when the user wants upload and attachment only.

Submit multiple review items

Read references/multi-item-submissions.md when the app version must ship with versioned IAP, subscription, subscription-group, or Game Center items. Add only items the user has resolved and inspected.

Handoff after submission

Report:

  • the app, version, platform, build, and submission IDs;
  • which lane ran and whether it completed;
  • every mutation confirmed by the user;
  • the exact command to monitor the resulting submission.

Use asc-submission-health for monitoring, cancellation, rejection diagnosis, or retry decisions.

Guardrails

  • Do not use removed submit-preflight, submit-create, or release-run shortcuts.
  • Do not add --confirm until the dry-run plan matches the requested release.
  • Do not create a second review submission when one already exists for the version.
  • Do not turn a validation failure into a partial release; stop at the failing gate.
  • Keep data on stdout and diagnostics on stderr when wrapping commands in automation.

What ships with it: 1 file

4.2 KB alongside SKILL.md

references/

Gives 0 of the 12 instructions most ship operate skills give

Counted across 1,077 of the 1,713 authors here whose files we hold, read 2026-09-06

  • Create GitHub releasein 44 of 1077, across 43 files
  • Run the test suitein 30 of 1077, across 25 files
  • Create and push git tagin 27 of 1077, across 26 files
  • Push commits and tagsin 27 of 1077
  • Create annotated tagin 25 of 1077, across 22 files
  • Ensure working tree is cleanin 24 of 1077
  • Check for product marketing context firstin 23 of 1077, across 6 files
  • Commit version bump changesin 22 of 1077, across 21 files
  • Update CHANGELOG.mdin 21 of 1077, across 20 files
  • Structure launch marketing across three channel typesin 20 of 1077, across 5 files
  • Commit and tag the releasein 20 of 1077, across 18 files
  • Update the CHANGELOG for new releasesin 19 of 1077

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once.

Keep looking

Skills are one crate of 612,213. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.