app-store-preflight-skills
>
pinned to #e52e007updated 2 weeks ago
Ask your AI client: “install skills/app-store-preflight-skills”.
Requires the metahub MCP server installed in your client. Set up MCP.
mh install skills/app-store-preflight-skillsmetahub onboarded this repo on the author's behalf.
If you own github.com/truongduy2611/app-store-preflight-skills on GitHub, claim the listing to take over publishing. Your claim preserves the existing eval history and badges; only the curator label is replaced with verified-publisher on your next publish.
Stars
1,287
Last commit
2 weeks ago
Latest release
published
About this skill
Pulled from SKILL.md at publish time.
Run pre-submission checks on your iOS/macOS project to catch common App Store rejection patterns.
Evaluation report
WarningsAutomated checks the publisher passed at publish time — structure, docs, safety, and whether the artifact behaves as claimed.e52e007· 2 weeks ago
Documentation
32Description qualitywarn
14 words · 92 chars — skills use the description as their trigger; aim higher — manifest description is empty; graded the GitHub repo description instead
Aim for 15+ words and include trigger phrases like “use this skill when …”.
README is present and substantial
5,765 chars · 12 sections · 2 code blocks
Tags / topics declaredwarn
No manifest tags and no GitHub repo topics
Add tags to the manifest (or GitHub topics on the repo) so the registry's search and category filters surface this artifact.
README has usage / example sections
found: Example
Homepage / docs URL declared
no homepage declared (registry will use the repo URL) — info-only, not blocking
Release history
1- releasecurrente52e007warn2 weeks ago
Contents
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 and 10 app-type specific checklists:
| Checklist | App Type |
|---|---|
| all_apps.md | Universal (every submission) |
| subscription_iap.md | Subscriptions / In-App Purchases |
| social_ugc.md | Social / User-Generated Content |
| kids.md | Kids Category |
| health_fitness.md | Health, Fitness & Medical |
| games.md | Games |
| macos.md | macOS / Mac App Store |
| ai_apps.md | AI / Generative AI |
| crypto_finance.md | Crypto, Finance & Trading |
| vpn.md | VPN & Networking |
📖 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 theasc-metadata-syncskill) - 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/)
| Rule | Guideline | What It Catches |
|---|---|---|
| review_notes_new_submission | 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 | 2.3.1 | Android, Google Play, and other competitor brands |
| apple_trademark | 5.2.5 | Apple device images in icon, Apple trademark misuse |
| china_storefront | 5 | OpenAI/ChatGPT/Gemini references (China) |
| accurate_metadata | 2.3.4 | Device frames in app preview videos |
| subscription_metadata | 3.1.2 | Missing ToS/EULA and Privacy Policy links |
Subscriptions (references/rules/subscription/)
| Rule | Guideline | What It Catches |
|---|---|---|
| missing_tos_pp | 3.1.2 | No Terms or Privacy Policy in app/metadata |
| misleading_pricing | 3.1.2 | Monthly price more prominent than billed amount |
Privacy (references/rules/privacy/)
| Rule | Guideline | What It Catches |
|---|---|---|
| unnecessary_data | 5.1.1 | Requiring irrelevant personal data |
| privacy_manifest | 5.1.1 | Missing PrivacyInfo.xcprivacy |
Design (references/rules/design/)
| Rule | Guideline | What It Catches |
|---|---|---|
| sign_in_with_apple | 4.0 | Asking name/email after SIWA |
| minimum_functionality | 4.2 | WebView wrappers, apps with < 3 screens, no unique value |
Entitlements (references/rules/entitlements/)
| Rule | Guideline | What It Catches |
|---|---|---|
| unused_entitlements | 2.4.5(i) | Unused entitlements in Xcode project |
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
- app-store-connect-cli-skills — ASC CLI skills for metadata sync, ASO audit, release flow
License
MIT
Reviews
No reviews yet. Be the first.
Related
Verification Before Completion
Evidence before assertions, always
Writing Plans
Turn specs into phased implementation plans
Test-Driven Development
Red → green → refactor discipline for any feature or bugfix
mh install skills/app-store-preflight-skills