/asc

name: asc
description: Drive App Store Connect from the terminal with the `asc` CLI — TestFlight builds, groups, testers and What to Test notes; App Store versions, metadata, keywords, screenshots and release notes; submissions and review health; signing, provisioning and notarization; crash and beta-feedback triage; pricing, subscriptions and Apple Ads. Use whenever the task touches App Store Connect, TestFlight, an App Store release or submission, or an iOS/macOS build upload. Route to the matching file under references/ before running commands.

asc — App Store Connect from the CLI

`asc` is installed via Homebrew (`brew install asc`). It is the only tool that should touch App Store Connect here — do not hand-roll JWTs or curl the API.

This skill is a router. Read the one reference that matches the task, not the whole set. Each reference is a self-contained playbook with the exact commands.

Before anything

Every command needs credentials. Check first:

asc auth status      # active profile
asc doctor           # diagnose a broken or missing setup

If nothing is stored, register a key (Key ID + Issuer ID + `.p8` from https://appstoreconnect.apple.com/access/integrations/api):

asc auth login --name <label> --key-id <KEY_ID> --issuer-id <UUID> \
  --private-key <path/to/AuthKey_XXXX.p8> --network

Most commands need an app or build ID rather than a name — see `references/asc-id-resolver.md`.

Routing table

| Task | Read | | --- | --- | | Flags, output formats, pagination, discovery — how to shape any `asc` command | `references/asc-cli-usage.md` | | Turn an app / build / version / group / tester name into an ID | `references/asc-id-resolver.md` | | TestFlight groups, testers, distribution, What to Test notes | `references/asc-testflight-orchestration.md` | | Build processing status, finding the latest build, retention cleanup | `references/asc-build-lifecycle.md` | | TestFlight crashes, beta feedback, hangs, launch diagnostics | `references/asc-crash-triage.md` | | Build, archive, export, bump version/build numbers, upload an IPA/PKG | `references/asc-xcode-build.md` | | Stage a version, publish, submit for review | `references/asc-release-flow.md` | | Validation failures, stuck submissions, cancel and retry decisions | `references/asc-submission-health.md` | | Pull, edit, validate and apply App Store metadata and keywords | `references/asc-metadata-sync.md` | | Write release notes (What's New) from git log or bullets | `references/asc-whats-new-writer.md` | | Translate metadata into more locales | `references/asc-localize-metadata.md` | | Offline ASO / keyword audit of pulled metadata | `references/asc-aso-audit.md` | | Capture, frame and upload screenshots (simulator pipeline) | `references/asc-shots-pipeline.md` | | Fix screenshot dimensions, alpha channels, validation errors | `references/asc-screenshot-resize.md` | | Bundle IDs, capabilities, certificates, provisioning profiles | `references/asc-signing-setup.md` | | Developer ID signing + notarization for distribution outside the App Store | `references/asc-notarization.md` | | Territory-specific / PPP pricing | `references/asc-ppp-pricing.md` | | Subscription and IAP display names across locales | `references/asc-subscription-localization.md` | | Reconcile the ASC catalog with RevenueCat | `references/asc-revenuecat-catalog-sync.md` | | Apple Ads campaigns, ad groups, keywords, reports | `references/asc-apple-ads.md` | | Repo-local multi-step automations (`.asc/workflow.json`) | `references/asc-workflow.md` | | Create a new app record (browser automation — no public API) | `references/asc-app-create-ui.md` | | Submit an entry to the asc Wall of Apps | `references/asc-wall-submit.md` |

References cross-name each other by their old skill names — a line saying "route to `asc-submission-health`" means `references/asc-submission-health.md` in this skill.

Provenance

Vendored from https://github.com/rorkai/app-store-connect-cli-skills at the commit `asc install-skills` pins (recorded per file in `skills-lock.json`). Upstream ships these as 23 separate top-level skills; here they are flattened into this one skill's `references/`, with each skill's own `references/` folder nested under `references/<skill-name>/` and its links rewritten to match. The prose is otherwise verbatim — do not hand-edit it. To update, run `asc install-skills`, then re-flatten from `~/.agents/skills/asc-*` and delete the global copies.