Aller au contenu
TakoAPI
Retour aux skills

app-store-audit-skill

par rahimdev4

Windsurf
—Pas encore noté
Ta note

Résumé

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.

Description

<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>

Installation

Installe le skill depuis https://github.com/rahimdev4/app-store-audit-skill

Ce skill n'est pas publié sur le registre ClawHub. Colle l'instruction dans ton agent de code — Claude Code, Cursor, Codex — et il installera le skill directement depuis le dépôt source.

Ouvrir le dépôt

Liens