โ๏ธ 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 (brew install asc) and the ASC 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
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:
๐ Full guideline reference: references/guidelines/README.md
How It Works
- Identify app type โ load the matching checklist from
references/guidelines/by-app-type/
- Pull metadata using
asc metadata pull --app "<APP_ID>" --version "<VERSION>" --dir ./metadata (or the asc-metadata-sync skill)
- Scan against rejection rules in
references/rules/
- Report findings with severity, affected files, and resolution steps
- Autofix + Validate โ apply fixes, re-run affected checks
See SKILL.md for the full AI agent instructions.
Rejection Rules
All rules live in references/rules/, organized by category:
Metadata (references/rules/metadata/)
Subscriptions (references/rules/subscription/)
Privacy (references/rules/privacy/)
Design (references/rules/design/)
| Rule | Guideline | What It Catches |
|---|
| sign_in_with_apple | 4.0 | Asking name/email after SIWA |
| minimum_functionality | 4.2, 4.3 | WebView wrappers, apps with < 3 screens, no unique value, saturated categories |
| hidden_features | 2.5.19 | Review-mode detection, time bombs, undocumented feature flags, obfuscated functionality |
Entitlements (references/rules/entitlements/)
Adding New Rules
Create a .md file in the appropriate references/rules/ subdirectory:
# 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
License
MIT