asc-testflight
Manage TestFlight beta groups and testers using the `asc` CLI tool. Use this skill when: (1) Listing beta groups for an app (`asc testflight groups list`) (2) Creating internal or external beta groups (`asc testflight groups create --internal`) (3) Listing testers in a group (`asc testflight testers list --group-id <id>`) (3) Adding a single tester by email (`asc testflight testers add`) (4) Removing a tester from a group (`asc testflight testers remove`) (5) Bulk-importing testers from a CSV file (`asc testflight testers import`) (6) Exporting testers to CSV for re-use (`asc testflight testers export`) (7) User says "add beta tester", "invite tester", "remove tester", "import testers", "export testers", "list beta groups", or any TestFlight tester management task
How do I install this agent skill?
npx skills add https://github.com/tddworks/asc-cli-skills --skill asc-testflightIs this agent skill safe to install?
- Gen Agent Trust Hubwarn
The skill facilitates the management of Apple TestFlight resources via the `asc` CLI. It involves accessing sensitive private key files for authentication and implements an affordance pattern that encourages the agent to execute commands directly from external tool output, presenting a risk of indirect prompt injection.
- Socketwarn
1 alert: gptAnomaly
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
TestFlight Beta Tester Management with asc
Manage beta groups and testers for your TestFlight distribution.
Authentication
Set up credentials before any TestFlight commands:
asc auth login --key-id <id> --issuer-id <id> --private-key-path ~/.asc/AuthKey.p8
CAEOAS — Affordances Guide Next Steps
Every JSON response includes "affordances" with ready-to-run commands:
BetaGroup affordances:
{
"id": "g-abc123",
"appId": "6450406024",
"name": "External Beta",
"affordances": {
"listTesters": "asc testflight testers list --group-id g-abc123",
"importTesters": "asc testflight testers import --group-id g-abc123 --file testers.csv",
"exportTesters": "asc testflight testers export --group-id g-abc123"
}
}
BetaTester affordances:
{
"id": "t-xyz789",
"groupId": "g-abc123",
"email": "jane@example.com",
"affordances": {
"listSiblings": "asc testflight testers list --group-id g-abc123",
"remove": "asc testflight testers remove --group-id g-abc123 --tester-id t-xyz789"
}
}
Copy affordance commands directly — no need to look up IDs.
Resolve App ID
See project-context.md — check .asc/project.json before asking the user or running asc apps list.
Typical Workflow
APP_ID=$(cat .asc/project.json 2>/dev/null | jq -r '.appId // empty')
# If empty: ask user or run `asc apps list | jq -r '.data[0].id'`
# 1. Find beta groups for an app
asc testflight groups list --app-id "$APP_ID" --pretty
# 2. List testers in a group (copy affordance "listTesters" from step 1)
asc testflight testers list --group-id g-abc123 --pretty
# 3. Add a single tester
asc testflight testers add \
--group-id g-abc123 \
--email jane@example.com \
--first-name Jane \
--last-name Doe
# 4. Remove a tester (copy affordance "remove" from tester JSON)
asc testflight testers remove --group-id g-abc123 --tester-id t-xyz789
# 5. Bulk import from CSV (header row required: email,firstName,lastName)
asc testflight testers import --group-id g-abc123 --file testers.csv
# 6. Export to CSV (pipe to file or use redirect)
asc testflight testers export --group-id g-abc123 > testers.csv
# 7. Clone a group's testers to a new group
asc testflight testers export --group-id g-abc123 > testers.csv
asc testflight testers import --group-id g-new456 --file testers.csv
CSV Format
Import/export CSV — header row required, firstName and lastName are optional:
email,firstName,lastName
jane@example.com,Jane,Doe
john@example.com,John,Smith
anon@example.com,,
Output Flags
--pretty # Pretty-print JSON
--output table # Table format
--output markdown # Markdown table
Full Command Reference
See commands.md for all flags, filters, and examples.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/tddworks/asc-cli-skills/asc-testflight">View asc-testflight on skillZs</a>