| name | asc-testflight-orchestration |
| description | Orchestrate TestFlight beta distribution, groups, testers, and What to Test notes using asc CLI. Use when rolling out beta builds, creating TestFlight groups, adding or inviting testers, distributing builds to groups, setting What to Test notes, or exporting TestFlight configuration. Triggers: "TestFlight", "beta testers", "beta group", "distribute beta", "testflight group", "add tester", "invite tester", "What to Test", "beta distribution", "asc testflight". |
asc TestFlight orchestration
Use this skill when managing TestFlight testers, groups, and build distribution.
Iron Law
NEVER ADD TESTERS OR DISTRIBUTE BUILDS WITHOUT FIRST CONFIRMING GROUP AND BUILD IDS — RUN asc-id-resolver FIRST
Use --paginate on all list commands for accounts with many testers or groups to avoid incomplete results.
Export current config
asc testflight sync pull --app "APP_ID" --output "./testflight.yaml"- Include builds/testers:
asc testflight sync pull --app "APP_ID" --output "./testflight.yaml" --include-builds --include-testers
Manage groups and testers
- Groups:
asc testflight beta-groups list --app "APP_ID" --paginateasc testflight beta-groups create --app "APP_ID" --name "Beta Testers"
- Testers:
asc testflight beta-testers list --app "APP_ID" --paginateasc testflight beta-testers add --app "APP_ID" --email "tester@example.com" --group "Beta Testers"asc testflight beta-testers invite --app "APP_ID" --email "tester@example.com"
Distribute builds
asc builds add-groups --build "BUILD_ID" --group "GROUP_ID"- Remove from group:
asc builds remove-groups --build "BUILD_ID" --group "GROUP_ID"
What to Test notes
asc builds test-notes create --build "BUILD_ID" --locale "en-US" --whats-new "Test instructions"asc builds test-notes update --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.
Documentation Sources
| Source | How to Access | Purpose |
|---|
| asc CLI help | asc testflight --help, asc builds --help | Current TestFlight distribution flags |
| asc-id-resolver skill | Load skill | Resolve group IDs, build IDs, tester emails to IDs |
