Skip to main content
affpapa.org
RU EN
skill CX Codex

asc-testflight-orchestration — Claude Code skill: how to install

Automates TestFlight rollout via the asc CLI: manages tester groups, links builds, exports configs, and sets What to Test release notes.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add rorkai/app-store-connect-cli-skills --skill asc-testflight-orchestration -a claude-code
Open on GitHub

What asc-testflight-orchestration does

This skill guides coding agents through managing TestFlight beta distributions using the asc command-line tool. It exports existing app setups to YAML, lists or creates tester groups, and handles tester invitations by email.

For releases, the agent links specific builds to groups using asc builds add-groups or removes them. It also supports uploading IPAs with --upload-only and publishing localized What to Test release notes.

Pay attention to upload limitations. Using --upload-only demands a fresh IPA or local Xcode build, and it will fail if merged with --build-id, release notes, or beta-review flags. Group inspection by build is experimental, so pass exact IDs to keep operations predictable.

What it helps with

  • export TestFlight configuration and tester lists to YAML
  • create tester groups and invite testers by email
  • attach builds to specific TestFlight groups
  • publish localized What to Test notes for a build
  • upload IPAs to App Store Connect without immediate release

Example prompts for the agent

  • Export the current TestFlight config for APP_ID with builds and testers to testflight.yaml
  • Add build BUILD_ID to group GROUP_ID using asc
  • Set What to Test notes in en-US for build BUILD_ID

How to install asc-testflight-orchestration

1Skills CLI (Vercel)

npx skills add rorkai/app-store-connect-cli-skills --skill asc-testflight-orchestration -a claude-code

2Manually: put the files in place

~/.claude/skills/asc-testflight-orchestration/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/asc-testflight-orchestration/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about asc-testflight-orchestration

How to install asc-testflight-orchestration in Claude Code?

Run npx skills add rorkai/app-store-connect-cli-skills --skill asc-testflight-orchestration -a claude-code in your terminal.

What does asc-testflight-orchestration do?

It lets AI agents handle TestFlight betas using asc, covering tester group management, invitations, build assignment, and What to Test notes.

What are the restrictions of the upload-only flag?

The --upload-only option requires a local IPA or Xcode build. It cannot be combined with an existing --build-id, tester groups, release notes, or beta review submissions.

Source text

SKILL.md · MIT 
---
name: asc-testflight-orchestration
description: Orchestrate TestFlight distribution, groups, testers, and What to Test notes using asc. Use when rolling out betas.
---

# asc TestFlight orchestration

Use this skill when managing TestFlight testers, groups, and build distribution.

## Export current config
- `asc testflight config export --app "APP_ID" --output "./testflight.yaml"`
- Include builds/testers:
  - `asc testflight config export --app "APP_ID" --output "./testflight.yaml" --include-builds --include-testers`

## Manage groups and testers
- Groups:
  - `asc testflight groups list --app "APP_ID" --paginate`
  - `asc testflight groups create --app "APP_ID" --name "Beta Testers"`
- Testers:
  - `asc testflight testers list --app "APP_ID" --paginate`
  - `asc testflight testers add --app "APP_ID" --email "[email protected]" --group "Beta Testers"`
  - `asc testflight testers invite --app "APP_ID" --email "[email protected]"`

## Distribute builds
- `asc builds add-groups --build-id "BUILD_ID" --group "GROUP_ID"`
- Remove from group:
  - `asc builds remove-groups --build-id "BUILD_ID" --group "GROUP_ID" --confirm`

## Inspect a build's groups
- `asc testflight groups list --build-id "BUILD_ID" --output table`
- The build lookup is experimental. It resolves the app, paginates the app's groups, and includes groups with all-build access.

## Upload without distribution
- `asc publish testflight --app "APP_ID" --ipa "./app.ipa" --upload-only --output json`
- Add `--wait` when the next step needs a processed build.
- Upload-only requires a new IPA or local Xcode build. Do not combine it with an existing `--build-id`, groups, tester notifications, test notes, or beta-review submission. `--build-number` is allowed as upload metadata, but it cannot be the only build input.

## What to Test notes
- `asc builds test-notes create --build-id "BUILD_ID" --locale "en-US" --whats-new "Test instructions"`
- `asc builds test-notes update --localization-id "LOCALIZATION_ID" --whats-new "Updated notes"`

## Notes
- Use `--paginate` on large groups/tester lists.
- Prefer IDs for deterministic operations; use the ID resolver skill when needed.

© rorkai · MIT · rorkai/app-store-connect-cli-skills

Similar skills

Everything for Mobile →
blitz blitzdotdev A native macOS app that hands your agent control of App Store Connect through MCP: builds, IAPs, screenshots, review submissions. CX Codex +1 ★ 1,760repo stars asc-metrics appeeky Analyzes first-party App Store Connect data synced via Appeeky Connect, tracking downloads, revenue, trials, and subscriptions. CX Codex +1 2,500installs expo-dev-client expo Skill for building and distributing custom Expo development clients to physical devices via local builds or TestFlight. Use it when your app includes native code, Apple widgets, or third-party native modules not in Expo Go. CX Codex +1 70,300installs axiom-shipping CharlesWiltgen A skill for App Store releases: pre-flight checklists, rejection and appeal handling, metadata, privacy manifests, and crash triage. CX Codex +1 1,400installs expo-app-clip expo Adds an iOS App Clip target to Expo projects — a lightweight app invoked from a URL without App Store installation. CX Codex +1 19,800installs ios-simulator-skill conorluddy Thirty Python scripts to build, test, and control iOS apps in Simulator. Navigate by accessibility labels instead of screenshots, manage logs, simulate GPS and appearance—all via structured data instead of pixel analysis. CX Codex +1 2,400installs

From the same set24

asc-submission-health Checks whether an App Store version is ready, names each submission blocker and routes the fix through the asc CLI. CX Codex +1 8,000installs asc-metadata-sync A skill for the asc CLI: pull App Store Connect metadata into local JSON, validate it, push it back. Useful when you are editing localizations, keywords or store assets. CX Codex +1 7,800installs asc-id-resolver Turns human-friendly app, build and tester names into the IDs that asc commands expect. Handy when you only have a name to work with. CX Codex +1 7,600installs asc-xcode-build Teaches your agent to drive the asc CLI for Xcode archives, IPA and PKG export, and version bumps. Useful when a build has to reach App Store Connect or TestFlight. CX Codex +1 7,600installs asc-ppp-pricing Sets subscription and in-app purchase prices by territory. Use it for regional pricing plans and checks before changing existing prices. CX Codex +1 7,300installs asc-signing-setup An agent skill that creates bundle IDs, certificates and provisioning profiles through the asc CLI, then shares them with a team over git. CX Codex +1 7,400installs asc-build-lifecycle A skill that hands the agent the asc commands for App Store Connect builds: latest build, processing state, next build number, old build cleanup. CX Codex +1 7,200installs asc-shots-pipeline Automates iOS builds, simulator screenshots, framing, and uploads through asc. Use it when screenshot capture needs a repeatable plan-driven flow. CX Codex +1 6,900installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor