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.