SKILL.md
asc cli usage
Use this skill when you need to run or design asc commands for App Store Connect.
Command discovery
- Always use
--helpto discover commands and flags.
asc --help
asc builds --help
asc builds list --help
Canonical verbs (current asc)
- Prefer
viewover legacygetaliases for read-only commands in docs and automation.
asc apps view --id "APP_ID"
asc versions view --version-id "VERSION_ID"
asc pricing availability view --app "APP_ID"
- Prefer
editfor update-only availability surfaces and other canonical edit flows.
asc pricing availability edit --app "APP_ID" --territory "USA,GBR" --available true
asc app-setup availability edit --app "APP_ID" --territory "USA,GBR" --available true
asc xcode version edit --build-number "42"
- Keep
setwhere the CLI intentionally models a higher-level replacement/configuration flow and--helpstill showssetas the canonical verb.
Flag conventions
- Use explicit long flags (e.g.,
--app,--output).
- Prefer explicit flags in automation; some newer commands can prompt for missing fields when run interactively.
- Destructive operations require
--confirm.
- Use
--paginatewhen the user wants all pages.
Output formats
- Output defaults are TTY-aware:
tablein interactive terminals,jsonwhen piped or non-interactive.
- Use
--output tableor--output markdownonly for human-readable output.
--prettyis only valid with JSON output.
Authentication and defaults
- Prefer keychain auth via
asc auth login.
- Fallback env vars:
ASC_KEY_ID,ASC_ISSUER_ID,ASC_PRIVATE_KEY_PATH,ASC_PRIVATE_KEY,ASC_PRIVATE_KEY_B64.
ASC_APP_IDcan provide a default app ID.
- When permissions are unclear, inspect exact API key role coverage with
asc web auth capabilities.
- This lives under the experimental web auth surface.
- It can resolve the current local auth by default, or inspect a specific key with
--key-id.
Timeouts
ASC_TIMEOUT/ASC_TIMEOUT_SECONDScontrol request timeouts.
ASC_UPLOAD_TIMEOUT/ASC_UPLOAD_TIMEOUT_SECONDScontrol upload timeouts.