App Store Review Skill

App Store Review Skill

<strong>Stop getting rejected. Catch every issue before Apple does.</strong>









Quick Start &nbsp;&bull;&nbsp;
What It Catches &nbsp;&bull;&nbsp;
Report Preview &nbsp;&bull;&nbsp;
How It Works

---

A Claude Code skill that scans your actual Swift code and Xcode project for App Store rejection reasons — not a checklist you read, but an automated audit that reads your files, finds problems, and tells you exactly what to fix.

Why?

~40% of iOS apps get rejected on first submission. The top reasons are all preventable:

• Missing PrivacyInfo.xcprivacy (ITMS-91053) — the #1 rejection reason since 2024
• Vague privacy permission strings ("Camera access needed")
• No account deletion flow (required since 2022)
• Widget extensions missing their own privacy manifest
• Hardcoded API keys, placeholder text, missing app icons

These aren't hard problems. They're easy to miss, tedious to check manually, and painful to discover after waiting days for Apple's review.

This skill checks all of them in one pass. It reads your project.pbxproj, every Info.plist, all your Swift files, entitlements, and asset catalogs — then produces a report with the exact file, line number, and fix for each issue.

Quick Start

Requires: Claude Code (Anthropic's CLI for Claude)

1. Install the skill:

npx skills add JustinPerea/app-store-review-skill

Or with Claude Code directly:

/install-skill https://github.com/JustinPerea/app-store-review-skill

2. Open any Xcode project and say:

Review my app for the App Store

That's it. Full report in about 3–5 minutes.

What It Catches

53 Automated Checks

Every check scans your actual source code with specific regex patterns and validation rules. Issues are classified by severity:

Severity	Meaning
BLOCKER	Apple will reject your app. Must fix before submitting.
WARNING	Likely rejection or review delay. Should fix.
INFO	Best practice. Won't cause rejection but improves quality.

Privacy & Data — 7 checks

• Privacy usage descriptions in Info.plist
• PrivacyInfo.xcprivacy with Required Reason APIs
• AI/ML service disclosure
• Export compliance declaration
• Third-party SDK privacy manifests
• App Tracking Transparency consistency
• Sensitive data in UserDefaults vs Keychain

UI & Assets — 8 checks

• App icon (1024x1024, no alpha)
• Launch screen configuration
• iPad support and device family
• Permission string quality (specific, not vague)
• Minimum functionality (not just a WebView wrapper)
• Broken or placeholder links
• Hardcoded prices in UI strings
• Placeholder and debug content ("Lorem ipsum", TODO, test URLs)

Entitlements & Config — 8 checks

• Entitlements file consistency across targets
• App Transport Security exceptions
• Version and build numbers
• Deployment target and SDK version
• Extension, widget, and App Group requirements
• URL scheme conflicts
• TestFlight vs App Store differences
• Background mode justification (no silent audio abuse)

Features & Compliance — 10 checks