Lewati ke konten
TakoAPI
Kembali ke skill

app-store-audit-skill

oleh rahimdev4

Windsurf
โ€”Belum ada penilaian
Penilaian Anda

Ringkasan

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.

Deskripsi

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

Instalasi

Pasang skill dari https://github.com/rahimdev4/app-store-audit-skill

Skill ini belum dipublikasikan di registri ClawHub. Tempel prompt ke coding agent Anda โ€” Claude Code, Cursor, Codex โ€” dan skill-nya akan dipasang langsung dari repositori sumbernya.

Buka repositori

Tautan