asc-cli-usage

The asc-cli-usage skill provides structured guidance for working with the `asc` command-line interface used to interact with App Store Connect within this repository. It is designed to help users correctly construct, interpret, and maintain consistent `asc` commands for reading and modifying App Store Connect resources. The skill focuses on standardizing command usage, improving discoverability, and reducing errors when working with CLI-based workflows.

This skill highlights key operational features of the `asc` CLI, including command discovery through `--help` at multiple levels (such as `asc --help` and subcommand help), and encourages the use of canonical verbs like `view` for read-only operations and `edit` for update workflows. It also documents flag conventions such as the preference for explicit long-form flags, the requirement of `--confirm` for destructive actions, and the use of `--paginate` for retrieving full multi-page results. Output handling is also standardized, with support for TTY-aware defaults, explicit output formats like table or markdown for readability, and JSON output for automation, including the constraint that `--pretty` only applies to JSON output.

In addition, the skill defines authentication and runtime behavior expectations, including keychain-based login via `asc auth login`, fallback environment variables for credentials, and optional defaults like `ASC_APP_ID`. It also outlines timeout controls for general requests and uploads using environment variables. Target users include developers, DevOps engineers, and release managers who automate App Store Connect workflows, manage app metadata, handle pricing and availability updates, and integrate `asc` into CI/CD pipelines. It is especially useful in environments where consistent CLI usage, predictable automation behavior, and secure authentication practices are required.