app-store-preflight-skills
Scan an iOS/macOS Xcode project for common App Store rejection patterns before submission. Use when preparing an app for App Store review, after receiving a rejection from Apple, or when auditing metadata, subscriptions, privacy manifests, entitlements, or design compliance. Integrates with the asc CLI for metadata inspection.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/truongduy2611-app-store-preflight-skills)HTML
<a href="/listings/truongduy2611-app-store-preflight-skills"><img src="/api/listings/truongduy2611-app-store-preflight-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
npx skills add truongduy2611/app-store-preflight-skills
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 136 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- ---
- name: app-store-preflight-skills
- description: >
- Scan an iOS/macOS Xcode project for common App Store rejection patterns before
- submission. Use when preparing an app for App Store review, after receiving a
- rejection from Apple, or when auditing metadata, subscriptions, privacy manifests,
- entitlements, or design compliance. Integrates with the asc CLI for metadata inspection.
- metadata:
- author: truongduy2611
- version: "1.1"
- guidelines-synced: "2026-10-16"
- ---
- # App Store Preflight Skill
- Run pre-submission checks on your iOS/macOS project to catch common App Store rejection patterns.
- ## Prerequisites
- - **asc CLI** — Install via Homebrew: `brew install asc` ([App-Store-Connect-CLI](https://github.com/rudrankriyam/App-Store-Connect-CLI))
- - **ASC CLI Skills** — [app-store-connect-cli-skills](https://github.com/rudrankriyam/app-store-connect-cli-skills) for `asc` usage patterns
- - **jq** — Optional, but used by some JSON-inspection examples in the rule docs
- ## Step 1: Identify App Type → Load Checklist
- Determine which guidelines apply by loading the relevant checklist from `references/guidelines/by-app-type/`. Always start with `all_apps.md`, then add the app-type-specific one:
- | App Type | Checklist |
- |----------|-----------|
- | Every app | `references/guidelines/by-app-type/all_apps.md` |
- | Subscriptions / IAP | `references/guidelines/by-app-type/subscription_iap.md` |
- | Social / UGC | `references/guidelines/by-app-type/social_ugc.md` |
- | Kids Category | `references/guidelines/by-app-type/kids.md` |
- | Health & Fitness | `references/guidelines/by-app-type/health_fitness.md` |
- | Games | `references/guidelines/by-app-type/games.md` |
- | macOS | `references/guidelines/by-app-type/macos.md` |
- | AI / Generative AI | `references/guidelines/by-app-type/ai_apps.md` |
- | Crypto & Finance | `references/guidelines/by-app-type/crypto_finance.md` |
- | VPN | `references/guidelines/by-app-type/vpn.md` |
- Full guideline index: `references/guidelines/README.md`
- ## Step 2: Pull Metadata for Inspection
- Pull the latest App Store metadata using the `asc` CLI:
- ```bash
- # Pull canonical metadata JSON for the version you want to review
- asc metadata pull --app "<APP_ID>" --version "<VERSION>" --dir ./metadata
- ```
- `asc metadata pull` writes app info files to `./metadata/app-info/*.json` and
- version-localization files to `./metadata/version/<VERSION>/*.json`.
- Most rule examples below assume the canonical JSON layout written by
- `asc metadata pull`.
- Creative assets (product page headers, search result assets; Guideline 2.3.14)
- live in App Store Connect's Asset Library. If your `asc` version doesn't pull
- them, review them by hand against 2.3.14.
- If you already have metadata in another layout (for example fastlane
- `metadata/`), either adapt the file-path examples to that structure or pull the
- canonical `asc` layout first.
- ## Step 3: Run Rejection Rule Checks
- For each category, load the relevant rule files from `references/rules/` and inspect. Each rule contains: **What to Check**, **How to Detect**, **Resolution**, and **Example Rejection**.
- | Category | Rule Files |
- |----------|------------|
- | Metadata | `references/rules/metadata/*.md` |
- | Subscription | `references/rules/subscription/*.md` |
- | Privacy | `references/rules/privacy/*.md` |
- | Design | `references/rules/design/*.md` |
- | Entitlements | `references/rules/entitlements/*.md` |
- ## Step 4: Report Findings
- Produce a summary report using this template:
- ```markdown
- ## Preflight Report
- ### ❌ Rejections Found (N)
- - [GUIDELINE X.X.X] Description of issue
- - File: path/to/offending/file
- - Fix: What to do
- ### ⚠️ Warnings (N)
- - [GUIDELINE X.X.X] Potential issue
- ### ✅ Passed (N)
- - [Category] All checks passed
- ```
- Order by severity: rejections first, then warnings, then passed.
- ## Step 5: Autofix + Validate
- Some issues can be auto-fixed:
- - **Competitor terms** → Suggest replacement text with competitor names removed
- - **Metadata character limits** → Show current vs. max length
- - **Missing links** → Generate template ToS/PP URLs
- After applying any auto-fix, **re-run the affected checks** to confirm the fix resolved the violation. Only mark as resolved once the re-scan passes.
- For issues requiring manual intervention (screenshots, UI redesign), provide clear instructions but do not auto-fix.
- ## Gotchas
- - **China storefront** — Banned AI terms (ChatGPT, Gemini, etc.) are checked across ALL locales, not just `zh-Hans`. Apple checks every locale visible in the China storefront.
- - **Privacy manifests** — `PrivacyInfo.xcprivacy` is required even if your app doesn't call Required Reason APIs directly. Third-party SDKs (Firebase, Amplitude, etc.) that use `UserDefaults` or `NSFileManager` trigger this requirement transitively.
- - **asc auth** — `asc metadata pull` requires App Store Connect authentication. Run `asc auth login` first, or set `ASC_KEY_ID`, `ASC_ISSUER_ID`, and one of `ASC_PRIVATE_KEY_PATH` / `ASC_PRIVATE_KEY` / `ASC_PRIVATE_KEY_B64`. If you're unsure what `asc` is picking up, run `asc auth doctor`.
- - **Subscription metadata** — Apple requires ToS/PP links in BOTH the App Store description AND the in-app subscription purchase screen. Missing either one is a separate rejection.
- - **Hidden features (2.5.19)** — Feature flags are allowed, but every feature they can turn on must be in the reviewed build, reachable by the reviewer, and described in the review notes. Gating features on review-environment checks (sandbox receipt, TestFlight) is bait-and-switch and can get the developer account terminated.
- - **Third-party AI (5.1.2(i))** — Proxying AI calls through your own backend doesn't exempt you: if prompts or user content reach OpenAI, Gemini, Anthropic, etc., the app needs a consent screen naming the provider *before* the first request.
- - **Sign in with Apple relay domain** — New relay addresses use `private.icloud.com` (from late 2026) in addition to `privaterelay.appleid.com`. Hard-coded domain checks break for new users.
- - **SDK minimum** — Uploads must be built with the iOS 26 SDK or later (since April 28, 2026). An older Xcode fails at upload, not at review.
- - **macOS entitlements** — Apple will ask you to justify every temporary exception entitlement (`com.apple.security.temporary-exception.*`). Remove entitlements you don't actively use.
- ## Adding New Rules
- Create a `.md` file in the appropriate `references/rules/` subdirectory:
- ```markdown
- # Rule: [Short Title]
- - **Guideline**: [Apple Guideline Number]
- - **Severity**: REJECTION | WARNING
- - **Category**: metadata | subscription | privacy | design | entitlements
- ## What to Check
- ## How to Detect
- ## Resolution
- ## Example Rejection
- ```
README.md · README · 116 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # ✈️ App Store Preflight
- An AI agent skill that runs pre-submission checks on your iOS/macOS project to catch common mistakes that lead to App Store rejection.
- ## Overview
- Preflight helps developers catch potential App Store Review guideline violations **before** submitting their app. It scans your Xcode project, source code, metadata, and configuration files to flag issues that commonly result in rejections from Apple.
- This skill integrates with the [`asc` CLI](https://github.com/rudrankriyam/App-Store-Connect-CLI) (`brew install asc`) and the [ASC CLI Skills](https://github.com/rudrankriyam/app-store-connect-cli-skills) to pull and inspect App Store metadata.
- Most metadata examples assume the canonical JSON layout written by
- `asc metadata pull`. If you are starting from fastlane metadata, adapt the path
- examples or pull the canonical `asc` layout first.
- ## Install
- ```bash
- npx skills add truongduy2611/app-store-preflight-skills
- ```
- ## Guideline Index (by App Type)
- The `references/guidelines/` directory contains a **complete index of all 100+ Apple Review Guidelines** (last synced with Apple's **October 16, 2026** revision) and **10 app-type specific checklists**:
- | Checklist | App Type |
- |-----------|----------|
- | [all_apps.md](./references/guidelines/by-app-type/all_apps.md) | Universal (every submission) |
- | [subscription_iap.md](./references/guidelines/by-app-type/subscription_iap.md) | Subscriptions / In-App Purchases |
- | [social_ugc.md](./references/guidelines/by-app-type/social_ugc.md) | Social / User-Generated Content |
- | [kids.md](./references/guidelines/by-app-type/kids.md) | Kids Category |
- | [health_fitness.md](./references/guidelines/by-app-type/health_fitness.md) | Health, Fitness & Medical |
- | [games.md](./references/guidelines/by-app-type/games.md) | Games |
- | [macos.md](./references/guidelines/by-app-type/macos.md) | macOS / Mac App Store |
- | [ai_apps.md](./references/guidelines/by-app-type/ai_apps.md) | AI / Generative AI |
- | [crypto_finance.md](./references/guidelines/by-app-type/crypto_finance.md) | Crypto, Finance & Trading |
- | [vpn.md](./references/guidelines/by-app-type/vpn.md) | VPN & Networking |
- 📖 Full guideline reference: [references/guidelines/README.md](./references/guidelines/README.md)
- ## How It Works
- 1. **Identify app type** → load the matching checklist from `references/guidelines/by-app-type/`
- 2. **Pull metadata** using `asc metadata pull --app "<APP_ID>" --version "<VERSION>" --dir ./metadata` (or the `asc-metadata-sync` skill)
- 3. **Scan** against rejection rules in `references/rules/`
- 4. **Report** findings with severity, affected files, and resolution steps
- 5. **Autofix + Validate** — apply fixes, re-run affected checks
- See [`SKILL.md`](./SKILL.md) for the full AI agent instructions.
- ## Rejection Rules
- All rules live in `references/rules/`, organized by category:
- ### Metadata (`references/rules/metadata/`)
- | Rule | Guideline | What It Catches |
- |------|-----------|-----------------|
- | [review_notes_new_submission](./references/rules/metadata/review_notes_new_submission.md) | 2.1 | Incomplete review notes for new app submissions (missing screen recording, app purpose, test credentials, external services, regional info, or regulatory docs) |
- | [competitor_terms](./references/rules/metadata/competitor_terms.md) | 2.3.10 | Android, Google Play, and other competitor brands |
- | [apple_trademark](./references/rules/metadata/apple_trademark.md) | 5.2.5 | Apple device images in icon, Apple trademark misuse |
- | [china_storefront](./references/rules/metadata/china_storefront.md) | 5 | OpenAI/ChatGPT/Gemini references (China) |
- | [accurate_metadata](./references/rules/metadata/accurate_metadata.md) | 2.3.4 | Device frames in app preview videos |
- | [subscription_metadata](./references/rules/metadata/subscription_metadata.md) | 3.1.2 | Missing ToS/EULA and Privacy Policy links |
- ### Subscriptions (`references/rules/subscription/`)
- | Rule | Guideline | What It Catches |
- |------|-----------|----------------|
- | [missing_tos_pp](./references/rules/subscription/missing_tos_pp.md) | 3.1.2 | No Terms or Privacy Policy in app/metadata |
- | [misleading_pricing](./references/rules/subscription/misleading_pricing.md) | 3.1.2 | Monthly price more prominent than billed amount |
- ### Privacy (`references/rules/privacy/`)
- | Rule | Guideline | What It Catches |
- |------|-----------|----------------|
- | [unnecessary_data](./references/rules/privacy/unnecessary_data.md) | 5.1.1 | Requiring irrelevant personal data |
- | [third_party_ai_consent](./references/rules/privacy/third_party_ai_consent.md) | 5.1.2(i) | Sending personal data to OpenAI/Gemini/Anthropic etc. without explicit consent |
- | [privacy_manifest](./references/rules/privacy/privacy_manifest.md) | 5.1.1 | Missing `PrivacyInfo.xcprivacy` |
- ### Design (`references/rules/design/`)
- | Rule | Guideline | What It Catches |
- |------|-----------|----------------|
- | [sign_in_with_apple](./references/rules/design/sign_in_with_apple.md) | 4.0 | Asking name/email after SIWA |
- | [minimum_functionality](./references/rules/design/minimum_functionality.md) | 4.2, 4.3 | WebView wrappers, apps with < 3 screens, no unique value, saturated categories |
- | [hidden_features](./references/rules/design/hidden_features.md) | 2.5.19 | Review-mode detection, time bombs, undocumented feature flags, obfuscated functionality |
- ### Entitlements (`references/rules/entitlements/`)
- | Rule | Guideline | What It Catches |
- |------|-----------|----------------|
- | [unused_entitlements](./references/rules/entitlements/unused_entitlements.md) | 2.4.5(i) | Unused entitlements in Xcode project |
- ## Adding New Rules
- Create a `.md` file in the appropriate `references/rules/` subdirectory:
- ```markdown
- # Rule: [Short Title]
- - **Guideline**: [Apple Guideline Number]
- - **Severity**: REJECTION | WARNING
- - **Category**: metadata | subscription | privacy | design | entitlements
- ## What to Check
- ## How to Detect
- ## Resolution
- ## Example Rejection
- ```
- ## Related Skills
- - [app-store-connect-cli-skills](https://github.com/rudrankriyam/app-store-connect-cli-skills) — ASC CLI skills for metadata sync, ASO audit, release flow
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.