asc-testflight-orchestration_skill

Overview

This skill orchestrates TestFlight distribution, groups, testers, and What to Test notes using the asc CLI. It helps automate exporting current configuration, managing beta groups and testers, assigning builds to groups, and updating localized test instructions. Use it to streamline repeatable beta rollouts and maintain deterministic state for TestFlight resources.

How this skill works

The skill runs asc CLI commands to pull TestFlight configuration, create and list beta groups and testers, add or remove builds from groups, and create or update build test notes. It supports exporting a YAML snapshot of current state and uses IDs for deterministic operations; a separate ID resolver can be used when only names are available. For large result sets, it uses pagination flags to ensure complete listings.

When to use it

• Preparing a new beta release and assigning builds to tester groups
• Onboarding or inviting multiple testers and organizing them into groups
• Exporting current TestFlight setup for backup or auditing
• Updating localized "What to Test" instructions for a build
• Automating repeatable, CI-driven beta rollouts

Best practices

• Export a testflight.yaml snapshot before making bulk changes to enable rollbacks
• Prefer numeric IDs for builds, groups, and localizations to keep operations deterministic
• Use --paginate when listing large numbers of testers or groups to avoid truncated results
• Keep "What to Test" notes localized and versioned to match the build localization IDs
• Automate sequences (pull → modify → push) in CI pipelines to reduce manual errors

Example use cases

• Pull the current TestFlight state: asc testflight sync pull --app "APP_ID" --output "./testflight.yaml"
• Create a new beta group and add testers: asc beta-groups create ... then asc beta-testers add --group "Beta Testers"
• Distribute a build to a group: asc builds add-groups --build "BUILD_ID" --group "GROUP_ID"
• Update test instructions for a localized build: asc builds test-notes update --id "LOCALIZATION_ID" --whats-new "Updated notes"
• Invite external testers in bulk and paginate through existing testers: asc beta-testers list --paginate