Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/truongduy2611-app-store-preflight-skills/badge.svg)](/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

i

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.

  1. ---
  2. name: app-store-preflight-skills
  3. description: >
  4. Scan an iOS/macOS Xcode project for common App Store rejection patterns before
  5. submission. Use when preparing an app for App Store review, after receiving a
  6. rejection from Apple, or when auditing metadata, subscriptions, privacy manifests,
  7. entitlements, or design compliance. Integrates with the asc CLI for metadata inspection.
  8. metadata:
  9. author: truongduy2611
  10. version: "1.1"
  11. guidelines-synced: "2026-10-16"
  12. ---
  13. # App Store Preflight Skill
  14. Run pre-submission checks on your iOS/macOS project to catch common App Store rejection patterns.
  15. ## Prerequisites
  16. - **asc CLI** — Install via Homebrew: `brew install asc` ([App-Store-Connect-CLI](https://github.com/rudrankriyam/App-Store-Connect-CLI))
  17. - **ASC CLI Skills** — [app-store-connect-cli-skills](https://github.com/rudrankriyam/app-store-connect-cli-skills) for `asc` usage patterns
  18. - **jq** — Optional, but used by some JSON-inspection examples in the rule docs
  19. ## Step 1: Identify App Type → Load Checklist
  20. 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:
  21. | App Type | Checklist |
  22. |----------|-----------|
  23. | Every app | `references/guidelines/by-app-type/all_apps.md` |
  24. | Subscriptions / IAP | `references/guidelines/by-app-type/subscription_iap.md` |
  25. | Social / UGC | `references/guidelines/by-app-type/social_ugc.md` |
  26. | Kids Category | `references/guidelines/by-app-type/kids.md` |
  27. | Health & Fitness | `references/guidelines/by-app-type/health_fitness.md` |
  28. | Games | `references/guidelines/by-app-type/games.md` |
  29. | macOS | `references/guidelines/by-app-type/macos.md` |
  30. | AI / Generative AI | `references/guidelines/by-app-type/ai_apps.md` |
  31. | Crypto & Finance | `references/guidelines/by-app-type/crypto_finance.md` |
  32. | VPN | `references/guidelines/by-app-type/vpn.md` |
  33. Full guideline index: `references/guidelines/README.md`
  34. ## Step 2: Pull Metadata for Inspection
  35. Pull the latest App Store metadata using the `asc` CLI:
  36. ```bash
  37. # Pull canonical metadata JSON for the version you want to review
  38. asc metadata pull --app "<APP_ID>" --version "<VERSION>" --dir ./metadata
  39. ```
  40. `asc metadata pull` writes app info files to `./metadata/app-info/*.json` and
  41. version-localization files to `./metadata/version/<VERSION>/*.json`.
  42. Most rule examples below assume the canonical JSON layout written by
  43. `asc metadata pull`.
  44. Creative assets (product page headers, search result assets; Guideline 2.3.14)
  45. live in App Store Connect's Asset Library. If your `asc` version doesn't pull
  46. them, review them by hand against 2.3.14.
  47. If you already have metadata in another layout (for example fastlane
  48. `metadata/`), either adapt the file-path examples to that structure or pull the
  49. canonical `asc` layout first.
  50. ## Step 3: Run Rejection Rule Checks
  51. 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**.
  52. | Category | Rule Files |
  53. |----------|------------|
  54. | Metadata | `references/rules/metadata/*.md` |
  55. | Subscription | `references/rules/subscription/*.md` |
  56. | Privacy | `references/rules/privacy/*.md` |
  57. | Design | `references/rules/design/*.md` |
  58. | Entitlements | `references/rules/entitlements/*.md` |
  59. ## Step 4: Report Findings
  60. Produce a summary report using this template:
  61. ```markdown
  62. ## Preflight Report
  63. ### ❌ Rejections Found (N)
  64. - [GUIDELINE X.X.X] Description of issue
  65. - File: path/to/offending/file
  66. - Fix: What to do
  67. ### ⚠️ Warnings (N)
  68. - [GUIDELINE X.X.X] Potential issue
  69. ### ✅ Passed (N)
  70. - [Category] All checks passed
  71. ```
  72. Order by severity: rejections first, then warnings, then passed.
  73. ## Step 5: Autofix + Validate
  74. Some issues can be auto-fixed:
  75. - **Competitor terms** → Suggest replacement text with competitor names removed
  76. - **Metadata character limits** → Show current vs. max length
  77. - **Missing links** → Generate template ToS/PP URLs
  78. 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.
  79. For issues requiring manual intervention (screenshots, UI redesign), provide clear instructions but do not auto-fix.
  80. ## Gotchas
  81. - **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.
  82. - **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.
  83. - **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`.
  84. - **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.
  85. - **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.
  86. - **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.
  87. - **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.
  88. - **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.
  89. - **macOS entitlements** — Apple will ask you to justify every temporary exception entitlement (`com.apple.security.temporary-exception.*`). Remove entitlements you don't actively use.
  90. ## Adding New Rules
  91. Create a `.md` file in the appropriate `references/rules/` subdirectory:
  92. ```markdown
  93. # Rule: [Short Title]
  94. - **Guideline**: [Apple Guideline Number]
  95. - **Severity**: REJECTION | WARNING
  96. - **Category**: metadata | subscription | privacy | design | entitlements
  97. ## What to Check
  98. ## How to Detect
  99. ## Resolution
  100. ## Example Rejection
  101. ```
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.

  1. # ✈️ App Store Preflight
  2. An AI agent skill that runs pre-submission checks on your iOS/macOS project to catch common mistakes that lead to App Store rejection.
  3. ## Overview
  4. 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.
  5. 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.
  6. Most metadata examples assume the canonical JSON layout written by
  7. `asc metadata pull`. If you are starting from fastlane metadata, adapt the path
  8. examples or pull the canonical `asc` layout first.
  9. ## Install
  10. ```bash
  11. npx skills add truongduy2611/app-store-preflight-skills
  12. ```
  13. ## Guideline Index (by App Type)
  14. 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**:
  15. | Checklist | App Type |
  16. |-----------|----------|
  17. | [all_apps.md](./references/guidelines/by-app-type/all_apps.md) | Universal (every submission) |
  18. | [subscription_iap.md](./references/guidelines/by-app-type/subscription_iap.md) | Subscriptions / In-App Purchases |
  19. | [social_ugc.md](./references/guidelines/by-app-type/social_ugc.md) | Social / User-Generated Content |
  20. | [kids.md](./references/guidelines/by-app-type/kids.md) | Kids Category |
  21. | [health_fitness.md](./references/guidelines/by-app-type/health_fitness.md) | Health, Fitness & Medical |
  22. | [games.md](./references/guidelines/by-app-type/games.md) | Games |
  23. | [macos.md](./references/guidelines/by-app-type/macos.md) | macOS / Mac App Store |
  24. | [ai_apps.md](./references/guidelines/by-app-type/ai_apps.md) | AI / Generative AI |
  25. | [crypto_finance.md](./references/guidelines/by-app-type/crypto_finance.md) | Crypto, Finance & Trading |
  26. | [vpn.md](./references/guidelines/by-app-type/vpn.md) | VPN & Networking |
  27. 📖 Full guideline reference: [references/guidelines/README.md](./references/guidelines/README.md)
  28. ## How It Works
  29. 1. **Identify app type** → load the matching checklist from `references/guidelines/by-app-type/`
  30. 2. **Pull metadata** using `asc metadata pull --app "<APP_ID>" --version "<VERSION>" --dir ./metadata` (or the `asc-metadata-sync` skill)
  31. 3. **Scan** against rejection rules in `references/rules/`
  32. 4. **Report** findings with severity, affected files, and resolution steps
  33. 5. **Autofix + Validate** — apply fixes, re-run affected checks
  34. See [`SKILL.md`](./SKILL.md) for the full AI agent instructions.
  35. ## Rejection Rules
  36. All rules live in `references/rules/`, organized by category:
  37. ### Metadata (`references/rules/metadata/`)
  38. | Rule | Guideline | What It Catches |
  39. |------|-----------|-----------------|
  40. | [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) |
  41. | [competitor_terms](./references/rules/metadata/competitor_terms.md) | 2.3.10 | Android, Google Play, and other competitor brands |
  42. | [apple_trademark](./references/rules/metadata/apple_trademark.md) | 5.2.5 | Apple device images in icon, Apple trademark misuse |
  43. | [china_storefront](./references/rules/metadata/china_storefront.md) | 5 | OpenAI/ChatGPT/Gemini references (China) |
  44. | [accurate_metadata](./references/rules/metadata/accurate_metadata.md) | 2.3.4 | Device frames in app preview videos |
  45. | [subscription_metadata](./references/rules/metadata/subscription_metadata.md) | 3.1.2 | Missing ToS/EULA and Privacy Policy links |
  46. ### Subscriptions (`references/rules/subscription/`)
  47. | Rule | Guideline | What It Catches |
  48. |------|-----------|----------------|
  49. | [missing_tos_pp](./references/rules/subscription/missing_tos_pp.md) | 3.1.2 | No Terms or Privacy Policy in app/metadata |
  50. | [misleading_pricing](./references/rules/subscription/misleading_pricing.md) | 3.1.2 | Monthly price more prominent than billed amount |
  51. ### Privacy (`references/rules/privacy/`)
  52. | Rule | Guideline | What It Catches |
  53. |------|-----------|----------------|
  54. | [unnecessary_data](./references/rules/privacy/unnecessary_data.md) | 5.1.1 | Requiring irrelevant personal data |
  55. | [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 |
  56. | [privacy_manifest](./references/rules/privacy/privacy_manifest.md) | 5.1.1 | Missing `PrivacyInfo.xcprivacy` |
  57. ### Design (`references/rules/design/`)
  58. | Rule | Guideline | What It Catches |
  59. |------|-----------|----------------|
  60. | [sign_in_with_apple](./references/rules/design/sign_in_with_apple.md) | 4.0 | Asking name/email after SIWA |
  61. | [minimum_functionality](./references/rules/design/minimum_functionality.md) | 4.2, 4.3 | WebView wrappers, apps with < 3 screens, no unique value, saturated categories |
  62. | [hidden_features](./references/rules/design/hidden_features.md) | 2.5.19 | Review-mode detection, time bombs, undocumented feature flags, obfuscated functionality |
  63. ### Entitlements (`references/rules/entitlements/`)
  64. | Rule | Guideline | What It Catches |
  65. |------|-----------|----------------|
  66. | [unused_entitlements](./references/rules/entitlements/unused_entitlements.md) | 2.4.5(i) | Unused entitlements in Xcode project |
  67. ## Adding New Rules
  68. Create a `.md` file in the appropriate `references/rules/` subdirectory:
  69. ```markdown
  70. # Rule: [Short Title]
  71. - **Guideline**: [Apple Guideline Number]
  72. - **Severity**: REJECTION | WARNING
  73. - **Category**: metadata | subscription | privacy | design | entitlements
  74. ## What to Check
  75. ## How to Detect
  76. ## Resolution
  77. ## Example Rejection
  78. ```
  79. ## Related Skills
  80. - [app-store-connect-cli-skills](https://github.com/rudrankriyam/app-store-connect-cli-skills) — ASC CLI skills for metadata sync, ASO audit, release flow
  81. ## License
  82. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.