asc

asc cli skills

A collection of Agent Skills for shipping with the asc cli (asc). These skills help agents run builds, TestFlight, metadata, submissions, signing, and Apple Ads workflows.

This is a community-maintained, unofficial skill pack and is not affiliated with Apple.

Skills follow the Agent Skills format.

Installation

Install this skill pack:

asc install-skills

Or install directly from GitHub:

npx skills add rorkai/app-store-connect-cli-skills

As a plugin (ADG / Claude Code / Codex)

This repo is also packaged as a plugin named asc. It is authored once in .agents/.plugin.json (ADG source of truth) and projected to the Claude (.claude-plugin/) and Codex (.codex-plugin/) runtime layouts. The skills stay at the repo root, so the installers above keep working unchanged.

ADG

adg plugins add rorkai/app-store-connect-cli-skills --global
adg plugins link --target claude --global   # Claude Code
adg plugins link --target codex  --global   # Codex

Claude Code (native marketplace) — discovers the plugin straight from this repo via .claude-plugin/marketplace.json:

claude plugin marketplace add rorkai/app-store-connect-cli-skills
claude plugin install asc@asc

Codex — Codex resolves plugins from a marketplace subdirectory, so install it through ADG, which lays the plugin out the way Codex expects:

adg plugins add rorkai/app-store-connect-cli-skills --global
adg plugins link --target codex --global

Available Skills

asc-cli-usage

Guidance for running asc commands (canonical verbs, flags, pagination, output, auth).

Use when:

• You need the correct asc command or flag combination
• You want JSON-first output and pagination tips for automation
• You need Apple Ads command, auth, org, payload, or pagination guidance

Example:

Find the right asc command to list all builds for app 123456789 as JSON and paginate through everything.

asc-apple-ads

Apple Ads auth, org lookup, campaigns, ad groups, ads, keywords, reports, raw API calls, and safe live testing.

Use when:

• You need to read or change Apple Ads resources with asc ads
• You need Apple Ads OAuth, profile, or ASC_ADS_* guidance
• You need a safe read-first plan before mutating a live Ads account

Example:

Find my Apple Ads org, list campaigns as JSON, and draft a safe plan before creating any test campaign.

asc-workflow

Define and run repo-local automation graphs using asc workflow and .asc/workflow.json.

Use when:

• You are migrating from lane-based automation to repo-local workflows
• You need multi-step orchestration with machine-parseable JSON output for CI/agents
• You need hooks (before_all, after_all, error), conditionals (if), and private helper sub-workflows
• You want validation (asc workflow validate) with cycle/reference checks before execution

Example:

Create an asc workflow that stages a release, validates it, and only submits when CONFIRM_RELEASE=true.

asc-app-create-ui

Create a new App Store Connect app via browser automation when no API exists.

Use when:

• You need to create an app record (name, bundle ID, SKU, primary language)
• You are comfortable logging in to App Store Connect in a real browser

Example:

Create a new App Store Connect app for com.example.myapp with SKU MYAPP123 and primary language English (U.S.).

asc-xcode-build

Build, archive, export, and manage Xcode version/build numbers before uploading.

Use when:

• You need to create an IPA or PKG for upload
• You're setting up CI/CD build pipelines
• You need to configure ExportOptions.plist
• You're troubleshooting encryption compliance issues

Example:

Archive and export my macOS app as a PKG I can upload to App Store Connect.

asc-shots-pipeline

Agent-first screenshot pipeline using xcodebuild/simctl, AXe, JSON plans, asc screenshots frame (experimental), and asc screenshots upload.

Use when:

• You need a repeatable simulator screenshot automation flow
• You want AXe-based UI driving before capture
• You need a staged pipeline (capture -> frame -> upload)
• You need to discover supported frame devices (asc screenshots list-frame-devices)
• You want pinned Koubou guidance for deterministic framing (koubou==0.18.1)

Example:

Build my iOS app, capture the home and settings screens in the simulator, frame them, and prepare them for upload.

asc-screenshot-resize

Resize and validate App Store screenshots with current asc screenshot-size data and macOS sips.

Use when:

• You need to prepare or fix screenshots for App Store Connect submission
• You want to resize images to the exact accepted dimensions for a device
• You need to validate screenshot sizes before upload

Example: