PluginBench
Skill
Pass
Audit score 90

asc-testflight-orchestration

rudrankriyam/app-store-connect-cli-skills

Orchestrate TestFlight distribution, groups, testers, and release notes via App Store Connect CLI.

What is asc-testflight-orchestration?

Manage TestFlight beta distribution including tester groups, individual testers, build assignments, and What to Test notes. Use this when rolling out beta versions and coordinating tester access across groups.

  • Export and import TestFlight configuration as YAML
  • Create and list tester groups
  • Add, invite, and manage individual testers
  • Distribute builds to specific tester groups
  • Remove builds from groups
  • Create and update What to Test release notes per locale

How to install asc-testflight-orchestration

npx skills add https://github.com/rudrankriyam/app-store-connect-cli-skills --skill asc-testflight-orchestration
Prerequisites
  • App Store Connect CLI (asc) installed and authenticated
  • Valid App ID and Build ID from App Store Connect
  • Tester email addresses for invitations
Claude Code
Cursor
Windsurf
Cline

How to use asc-testflight-orchestration

  1. 1.Export your current TestFlight configuration with `asc testflight config export --app "APP_ID" --output "./testflight.yaml"`
  2. 2.List existing groups with `asc testflight groups list --app "APP_ID" --paginate` or create new ones with `asc testflight groups create --app "APP_ID" --name "Group Name"`
  3. 3.Add testers with `asc testflight testers add --app "APP_ID" --email "tester@example.com" --group "Group Name"` or invite them with `asc testflight testers invite`
  4. 4.Distribute a build to a group using `asc builds add-groups --build-id "BUILD_ID" --group "GROUP_ID"`
  5. 5.Add What to Test notes with `asc builds test-notes create --build-id "BUILD_ID" --locale "en-US" --whats-new "Instructions"`

Use cases

Good for
  • Rolling out a new beta build to a subset of testers in a specific group
  • Exporting current TestFlight setup for version control or backup
  • Adding new testers and organizing them into groups by role or region
  • Updating release notes with test instructions for a build
  • Removing a build from a group after testing is complete
Who it's for
  • iOS/macOS app developers managing beta programs
  • QA leads coordinating TestFlight tester groups
  • Release managers orchestrating phased beta rollouts
  • App teams using App Store Connect CLI for automation

asc-testflight-orchestration FAQ

How do I export my current TestFlight setup?

Run `asc testflight config export --app "APP_ID" --output "./testflight.yaml"`. Add `--include-builds --include-testers` to include build and tester data in the export.

How do I add a tester to a specific group?

Use `asc testflight testers add --app "APP_ID" --email "tester@example.com" --group "Group Name"` to add an existing or new tester to a group.

What's the difference between add and invite?

Use `testers add` to add a tester to a group; use `testers invite` to send an invitation email to a tester's email address.

How do I update What to Test notes after creating them?

Use `asc builds test-notes update --localization-id "LOCALIZATION_ID" --whats-new "Updated notes"` with the localization ID from the created notes.

Should I use names or IDs for commands?

Prefer IDs for deterministic operations; use the ID resolver skill when you need to convert names to IDs.

Full instructions (SKILL.md)

Source of truth, from rudrankriyam/app-store-connect-cli-skills.


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 "tester@example.com" --group "Beta Testers"
    • asc testflight testers invite --app "APP_ID" --email "tester@example.com"

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

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.