Agent Skills › malpern/VoxClaw › asc-cli-usage

asc-cli-usage

GitHub

提供 asc CLI 在仓库中的使用指南，涵盖命令发现、规范动词、标志约定、输出格式及认证配置。用于指导运行或设计 App Store Connect 的 CLI 交互命令。

.claude/commands/asc-cli-usage/SKILL.md malpern/VoxClaw

Trigger Scenarios

询问如何运行 asc 命令需要设计 App Store Connect CLI 交互流程

Install

npx skills add malpern/VoxClaw --skill asc-cli-usage -g -y

More Options

Non-standard path

npx skills add https://github.com/malpern/VoxClaw/tree/main/.claude/commands/asc-cli-usage -g -y

Use without installing

npx skills use malpern/VoxClaw@asc-cli-usage

指定 Agent (Claude Code)

npx skills add malpern/VoxClaw --skill asc-cli-usage -a claude-code -g -y

安装 repo 全部 skill

npx skills add malpern/VoxClaw --all -g -y

预览 repo 内 skill

npx skills add malpern/VoxClaw --list

SKILL.md

Frontmatter

{
    "name": "asc-cli-usage",
    "description": "Guidance for using asc cli in this repo (flags, output formats, pagination, auth, and discovery). Use when asked to run or design asc commands or interact with App Store Connect via the CLI."
}

asc cli usage

Use this skill when you need to run or design asc commands for App Store Connect.

Command discovery

Always use --help to discover commands and flags.
- asc --help
- asc builds --help
- asc builds list --help

Canonical verbs (current asc)

Prefer view over legacy get aliases 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 edit for 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 set where the CLI intentionally models a higher-level replacement/configuration flow and --help still shows set as 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 --paginate when the user wants all pages.

Output formats

Output defaults are TTY-aware: table in interactive terminals, json when piped or non-interactive.
Use --output table or --output markdown only for human-readable output.
--pretty is 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_ID can 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.