app-store-preflight-skills

app-store-preflight-skills scans an iOS/macOS Xcode project for common App Store rejection patterns before submission. It solves a costly, recurring problem for Apple developers: catching metadata, subscription, privacy-manifest, entitlement, and design-compliance issues before Apple's reviewers do, or diagnosing a rejection after one arrives. The skill ships an extensive library of guideline checklists and rule files organized by app type and by rejection category.

The workflow is a five-step process: identify the app type and load the relevant checklist (starting from all_apps.md, then adding type-specific ones such as subscription/IAP, kids, health, games, macOS, AI, crypto/finance, or VPN); pull the latest App Store metadata using the asc CLI (`asc metadata pull`); run rejection-rule checks across metadata, subscription, privacy, design, and entitlements categories, each rule documenting what to check, how to detect it, resolution, and an example rejection; produce a severity-ordered preflight report of rejections, warnings, and passes; and apply safe auto-fixes (such as removing competitor terms or flagging character-limit overruns) followed by a re-scan to confirm resolution. It also documents notable gotchas around China-storefront banned terms, transitive privacy-manifest requirements from third-party SDKs, asc authentication, subscription ToS/PP link placement, and macOS temporary-exception entitlements.

The target users are iOS and macOS developers and release engineers preparing an App Store submission or recovering from a rejection. Credentials for the asc CLI are handled through standard App Store Connect authentication (asc auth login or documented environment variables such as ASC_KEY_ID and ASC_ISSUER_ID); the skill is defensive and compliance-oriented, reading metadata and reporting issues rather than performing any destructive action.