Torna alle skill
app-store-audit-skill
di rahimdev4
WindsurfโNon ancora valutato
La tua valutazione
Sintesi
AI-powered pre-submission audit for Apple App Store & Google Play Store. 140+ rules across 21 categories to catch rejection risks before you submit. Works with Cursor, Claude.ai, Gemini, Copilot, Windsurf & any AI coding assistant.
Descrizione
<p align="center">
<h1 align="center">๐ก๏ธ App Store Audit Skill</h1>
<p align="center">
<strong>AI-powered pre-submission audit for Apple App Store & Google Play Store</strong>
</p>
<p align="center">
Catch rejection risks before you submit. Save days of review cycles.<br/>
Works with <b>any</b> mobile framework โ Flutter โข React Native โข Swift โข Kotlin โข KMP โข Jetpack Compose โข Java
</p>
<p align="center">
<a href="#quick-start"><img src="https://img.shields.io/badge/Quick_Start-blue?style=for-the-badge" alt="Quick Start" /></a>
<a href="https://github.com/Rahimdev4/app-store-audit-skill/stargazers"><img src="https://img.shields.io/github/stars/Rahimdev4/app-store-audit-skill?style=for-the-badge&color=yellow" alt="Stars" /></a>
<a href="#license"><img src="https://img.shields.io/badge/License-MIT-green?style=for-the-badge" alt="License" /></a>
</p>
<p align="center">
<img src="https://img.shields.io/badge/Flutter-02569B?style=flat-square&logo=flutter&logoColor=white" alt="Flutter" />
<img src="https://img.shields.io/badge/React_Native-61DAFB?style=flat-square&logo=react&logoColor=black" alt="React Native" />
<img src="https://img.shields.io/badge/Swift-FA7343?style=flat-square&logo=swift&logoColor=white" alt="Swift" />
<img src="https://img.shields.io/badge/Kotlin-7F52FF?style=flat-square&logo=kotlin&logoColor=white" alt="Kotlin" />
<img src="https://img.shields.io/badge/Jetpack_Compose-4285F4?style=flat-square&logo=jetpackcompose&logoColor=white" alt="Jetpack Compose" />
<img src="https://img.shields.io/badge/Java-ED8B00?style=flat-square&logo=openjdk&logoColor=white" alt="Java" />
<img src="https://img.shields.io/badge/SwiftUI-000000?style=flat-square&logo=swift&logoColor=white" alt="SwiftUI" />
<img src="https://img.shields.io/badge/KMP-7F52FF?style=flat-square&logo=kotlin&logoColor=white" alt="KMP" />
</p>
</p>
---
## ๐ธ See It In Action
> Real audit report generated on a Flutter project โ no setup, just one prompt.
### 1. The Dashboard View
*Instant overview of your app's submission readiness across all categories and the 4 Layers of Review.*
<p align="center">
<img src="assets/dashboard-view.png" alt="Dashboard View โ Category summary and Layer Assessment" width="800" />
</p>
### 2. The Deep Code Audit
*Finds exact files, line numbers, and tells you precisely what's wrong and how to fix it.*
<p align="center">
<img src="assets/deep-code-audit-1.png" alt="Deep Code Audit โ Critical issues with file paths and fix steps" width="800" />
</p>
<p align="center">
<img src="assets/deep-code-audit-2.png" alt="Deep Code Audit โ Storage permission and legal link violations" width="800" />
</p>
---
## ๐ก Why This Exists
Every mobile developer has been there:
> You spend days polishing your app โ upload to the store โ wait 24-48 hours โ **REJECTED.**
> Fix one issue โ resubmit โ wait again โ **REJECTED for something else.**
> Repeat until you question your career choices.
**This skill was born from real rejections.** It's a comprehensive ruleset that teaches AI coding assistants to audit your app *before* you submit โ catching the same issues Apple and Google reviewers look for.
> **Framework-agnostic:** App Store and Play Store reviewers don't care if you built with Flutter, React Native, Swift, or Kotlin. A rejection is a rejection. This skill works with **any** mobile framework.
### What It Catches
| Category | Apple | Google | Examples |
|----------|:-----:|:------:|----------|
| ๐ณ Payments & Billing | โ
| โ
| Custom promo codes, missing restore button, external payment links |
| ๐ Privacy & Permissions | โ
| โ
| Missing privacy policy, excessive permissions, ATT compliance |
| โ๏ธ Intellectual Property | โ
| โ
| Content rights, trademark misuse, video downloading |
| ๐จ UI & Design Quality | โ
| โ
| Broken layouts, confusing navigation, unreadable text |
| ๐ App Completeness | โ
| โ
| Crashes, broken buttons, placeholder content, dead APIs |
| โก Performance | โ
| โ
| Lag, battery drain, memory leaks, ANR |
| ๐ Security & Malware | โ
| โ
| Hidden features, data stealing, obfuscated code |
| ๐ Store Metadata | โ
| โ
| Screenshot issues, version mismatch, misleading description |
| ๐ซ Spam & Duplicates | โ
| โ
| Clone apps, no user value, template apps |
| โ ๏ธ Content Policy | โ
| โ
| Adult content, hate speech, gambling, dangerous activities |
| ๐ญ Misleading Functionality | โ
| โ
| Fake features, hidden functionality, fake buttons |
| ๐ฑ Platform-Specific | โ
| โ
| Target SDK, 64-bit, .aab format, Info.plist flags |
| ๐ค AI & Machine Learning | โ
| โ
| Safety filters, content moderation, dynamic code execution |
| ๐ก๏ธ Privacy Manifests | โ
| โ | PrivacyInfo.xcprivacy, Required Reason APIs, SDK signatures |
| ๐ Authentication | โ
| โ๏ธ | Sign in with Apple enforcement, social login compliance |
| ๐๏ธ Account & Data Deletion | โ
| โ
| In-app deletion, SIWA token revocation, web deletion URL |
| ๐ถ Families & Kids | โ | โ
| COPPA compliance, ad ID restrictions, age-gating |
| ๐ท Media Permissions | โ | โ
| Photo Picker API, broad media access declarations |
| โ๏ธ Foreground Services | โ | โ
| Service type declarations, geofencing restrictions |
| ๐ช๐บ EU DMA Compliance | โ
| โ | Alternative payments, browser engines, offers promotion |
> **140+ audit rules** across **32 categories** โ based on official guidelines and real-world rejections.
---
## Quick Start
### Step 1: Add to Your Project
Copy the `app-store-audit-skill/` folder to your project root:
**Flutter:**
```
your-flutter-project/
โโโ app-store-audit-skill/
โ โโโ README.md โ You're reading this
โ โโโ AUDIT_SKILL.md โ The audit rules (the AI reads this)
โโโ lib/
โโโ pubspec.yaml
โโโ ...
```
**React Native:**
```
your-rn-project/
โโโ app-store-audit-skill/
โ โโโ README.md
โ โโโ AUDIT_SKILL.md
โโโ src/
โโโ package.json
โโโ ...
```
**Native iOS (Swift / SwiftUI):**
```
your-ios-project/
โโโ app-store-audit-skill/
โ โโโ README.md
โ โโโ AUDIT_SKILL.md
โโโ MyApp/
โโโ MyApp.xcodeproj
โโโ ...
```
**Native Android (Kotlin / Java / Jetpack Compose):**
```
your-android-project/
โโโ app-store-audit-skill/
โ โโโ README.md
โ โโโ AUDIT_SKILL.md
โโโ app/src/main/
โโโ build.gradle.kts
โโโ ...
```
**KMP (Kotlin Multiplatform):**
```
your-kmp-project/
โโโ app-store-audit-skill/
โ โโโ README.md
โ โโโ AUDIT_SKILL.md
โโโ shared/
โโโ androidApp/
โโโ iosApp/
โโโ ...
```
### Step 2: Run the Audit
Open your AI coding assistant (Cursor, Windsurf, Gemini CLI, etc.) and ask:
```
Audit my app for App Store and Play Store rejection risks.
Use the audit skill in app-store-audit-skill/AUDIT_SKILL.md
```
Or be more specific:
```
I'm about to submit my iOS app to the App Store.
Read app-store-audit-skill/AUDIT_SKILL.md and audit my codebase for rejection risks.
Focus on payments and subscription compliance.
```
### Step 3: Review the Report
The AI will generate a report like this:
```
๐ก๏ธ App Store Audit Report
App: My Awesome App
Version: 2.1.0
Platforms: iOS, Android
๐ด Critical Issues (Will Cause Rejection)
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
1. [AAPL-3.1.1-001] Custom promo code field found on paywall
โ File: lib/views/paywall.dart:142
โ Fix: Remove promo code field from iOS. Use Apple Offer Codes instead.
2. [AAPL-3.1.2-001] Missing "Restore Purchases" button
โ File: lib/views/paywall.dart
โ Fix: Add a Restore Purchases button on the subscription screen.
๐ก Warnings (May Cause Rejection)
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
1. [AAPL-META-002] Version "2.0.0" shown in Profile doesn't match
pubspec.yaml version "2.1.0"
โ File: lib/views/profile.dart:89
โ
Passed: Privacy, Content, UI, Performance
```
### Step 4: Fix & Submit
Fix the flagged issues, then submit with confidence! ๐
---
## ๐ File Structure
| File | Purpose | Who Reads It |
|------|---------|-------------|
| `README.md` | Introduction, setup guide, examples | **You** (the developer) |
| `AUDIT_SKILL.md` | Complete audit rules, checklists, AI instructions | **Your AI assistant** |
> **Note:** The AI reads `AUDIT_SKILL.md` to understand the rules. You don't need to memorize them โ that's the AI's job.
---
## ๐ฏ Supported Platforms & Frameworks
| Platform | Supported | Guidelines Covered |
|----------|:---------:|-------------------|
| ๐ Apple App Store | โ
| Review Guidelines 2.x โ 5.x, HIG, Metadata |
| ๐ค Google Play Store | โ
| Developer Program Policy, Billing, Data Safety |
| ๐ Web (PWA) | ๐ | Coming soon |
| Framework | Supported | Auto-detected |
|-----------|:---------:|:-------------:|
| Flutter (Dart) | โ
| โ
|
| React Native (JS/TS) | โ
| โ
|
| Native iOS (Swift / SwiftUI) | โ
| โ
|
| Native Android (Kotlin / Jetpack Compose) | โ
| โ
|
| Native Android (Java) | โ
| โ
|
| Kotlin Multiplatform (KMP) | โ
| โ
|
| Xamarin / .NET MAUI | โ
| โ
|
| Ionic / Capacitor | โ
| โ |
---
## ๐ ๏ธ Supported AI Tools
This skill works with any AI coding assistant that can read files:
| Tool | How to Use |
|------|-----------|
| **Gemini CLI / Antigravity** | Point to `AUDIT_SKILL.md` in your prompt |
| **Cursor** | Add `AUDIT_SKILL.md` to `.cursor/rules/` or reference in chat |
| **GitHub Copilot** | Reference the file in Copilot Chat |
| **Windsurf** | Add to Cascade rules or reference in chat |
| **Cline / Aider** | Include in system prompt or reference file |
---
## ๐ Real-World Rejection Cases
These are actual rejections that led to rules in this skill:
| App | Store | What Happened | Rule Added |
|-----|-------|--------------|------------|
| B3G TV | Apple | Custom promo code field on paywall โ rejected even though codes were tracking-only, no discount | `AAPL-3.1.1-001` |
| B3G TV | Apple | Streaming app content rights questioned โ required ownership statement | `AAPL-5.2.3-002` |
| B3G TV | Apple | App Privacy section not filled โ required Admin role in App Store Connect | `AAPL-META-007` |
> **Have a rejection story?** [Open an issue](https://github.com/Rahimdev4/app-store-audit-skill/issues) or submit a PR to add your case!
---
## ๐ค Contributing
We welcome contributions! Here's how:
1. **Found a new rejection case?** Add it to `AUDIT_SKILL.md`
2. **Know a rule we missed?** Open an issue or PR
3. **Built something cool with this?** Let us know!
### Rule ID Format
When adding rules, follow this format:
```
PLATFORM-CATEGORY-NUMBER
Examples:
AAPL-3.1.1-001 โ Apple, Guideline 3.1.1, Rule #001
GOOG-BILL-003 โ Google, Billing, Rule #003
```
---
## ๐ Stats
- **140+** audit rules
- **2** store platforms covered (Apple + Google)
- **7+** frameworks supported (Flutter, React Native, Swift, Kotlin, KMP, Java, Compose)
- **32** categories (including AI content, privacy manifests, account deletion, families policy)
- **4 Layers of Rejection** framework
- **Auto-detection** of project framework by AI
- **Complete implementation guides** for account deletion (Apple + Google)
- **Built from real rejections** โ not just docs
---
## โญ Support
If this saved you from a rejection, please:
1. **Star this repo** โญ โ it helps other developers find it
2. **Share with your team** โ save everyone's time
3. **Report new cases** โ help us grow the ruleset
---
## License
MIT License โ use freely in personal and commercial projects.
---
<p align="center">
<strong>Built with frustration, tested with real rejections.</strong><br/>
<em>Because no developer should waste days on preventable App Store rejections.</em>
</p>
<p align="center">
Made with โค๏ธ by <a href="https://rahimdev.net/">RahimDev</a>
</p>
Installazione
Installa la skill da https://github.com/rahimdev4/app-store-audit-skillQuesta skill non รจ pubblicata sul registro ClawHub. Incolla il prompt nel tuo agente di coding โ Claude Code, Cursor, Codex โ e installerร la skill direttamente dal repository sorgente.
Apri il repository