asc-metadata-yaml

App Store metadata (YAML source of truth)

All App Store Connect metadata for this app is declared in sectioned YAML under ./metadata/. Treat these files as the authoritative pre-population — App Store Connect is a downstream projection of this directory, never the reverse.

Why this exists

Populating App Store Connect manually on every release leaks state, wastes time, and loses locale parity. This skill replaces guessing with a versioned, reviewable pre-population:

• Every ASC field has a canonical home — one YAML file per ASC section.
• Every file tracks its own _status — so we know what's synced, what's drafted, and what diverged.
• Every push command is documented — the skill maps each section to the asc subcommand that pushes it, or flags it as manual_only when no API exists.

This skill never stores app-specific copy inline; it points at the files. Copy lives in ./metadata/, and any research should live in project-local references.

When to use

Invoke on any of these triggers:

• Creating or editing App Store copy, subtitle, keywords, description, promo text, or What's New
• Preparing a new version for submission (asc release, asc submit)
• Auditing whether ASC is in sync with the repo
• Adding a locale or an IAP/subscription
• Changing pricing, category, age rating, review info, or privacy declarations
• Before asc metadata push — verify the YAML passes schema checks
• After asc metadata pull — reconcile drift into the YAML

Directory layout

metadata/
├── app.yaml                       # app identity (name, bundle, sku, primary locale, platforms, content rights)
├── version.yaml                   # current version info (versionString, copyright, releaseType, releaseDate)
├── categories.yaml                # primary + secondary category
├── age-rating.yaml                # age rating declarations
├── content-rights.yaml            # third-party content declaration
├── encryption.yaml                # export compliance (ITSAppUsesNonExemptEncryption + exemptions)
├── privacy.yaml                   # App Privacy (data categories × purposes × linkage × tracking)
├── pricing.yaml                   # price point + territory availability
├── review-info.yaml               # review contact + demo account + reviewer notes
├── testflight.yaml                # beta license, feedback email, beta description, review contact
├── screenshots.yaml               # per-device-class manifests, paths to PNG/MP4 assets
├── locales/
│   ├── en-US.yaml                 # per-locale copy: subtitle, description, keywords, promo, whatsNew, URLs
│   └── <other-locales>.yaml
├── iap/
│   └── <product-id>.yaml          # one file per IAP: type, price, review screenshot, localizations
├── subscriptions/
│   └── <group-ref-name>.yaml      # one file per subscription group, with its subscriptions nested
├── status.yaml                    # auto-generated rollup (do not edit by hand)
└── README.md                      # link back to this skill