Skip to content
Back to search

app-store-review

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/safaiyeh-app-store-review-skill/badge.svg)](/listings/safaiyeh-app-store-review-skill)

HTML

<a href="/listings/safaiyeh-app-store-review-skill"><img src="/api/listings/safaiyeh-app-store-review-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Codex

Add this repository as a Codex plugin marketplace:

codex plugin marketplace add safaiyeh/app-store-review-skill

Then open Codex, run `/plugins`, choose the App Store Review marketplace, and install the `app-store-review` plugin. Start a new thread and invoke the skill with `$app-store-review` or ask for an App Store compliance review.

Codex also discovers direct local skills from `~/.agents/skills`, but plugins are the recommended distribution path for reusable skills.

Claude Code Plugin Marketplace

/plugin marketplace add safaiyeh/app-store-review-skill
/plugin install app-store-review@app-store-review

skills.sh

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 23 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "app-store-review",
  3. "owner": {
  4. "name": "safaiyeh"
  5. },
  6. "metadata": {
  7. "description": "Apple App Store Review Guidelines skill for Claude Code"
  8. },
  9. "plugins": [
  10. {
  11. "name": "app-store-review",
  12. "source": "./",
  13. "description": "Evaluates code against Apple's App Store Review Guidelines for iOS, macOS, tvOS, watchOS, and visionOS apps",
  14. "version": "1.5.0",
  15. "author": {
  16. "name": "safaiyeh"
  17. },
  18. "category": "compliance",
  19. "tags": ["apple", "app-store", "review", "guidelines", "ios", "swift", "react-native"],
  20. "strict": true
  21. }
  22. ]
  23. }
README.md · README · 216 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # App Store Review Guidelines Skill
  2. An AI agent skill that exhaustively evaluates iOS, macOS, tvOS, watchOS, and visionOS app code against **every point** in Apple's App Store Review Guidelines.
  3. **Supports:** Swift, Objective-C, **React Native**, and **Expo** apps
  4. **Current through:** Apple's official [October 16, 2026 App Review Guidelines update](https://developer.apple.com/news/?id=92th7e5i)
  5. ## Installation
  6. ### Codex
  7. Add this repository as a Codex plugin marketplace:
  8. ```bash
  9. codex plugin marketplace add safaiyeh/app-store-review-skill
  10. ```
  11. Then open Codex, run `/plugins`, choose the App Store Review marketplace, and install the `app-store-review` plugin. Start a new thread and invoke the skill with `$app-store-review` or ask for an App Store compliance review.
  12. Codex also discovers direct local skills from `~/.agents/skills`, but plugins are the recommended distribution path for reusable skills.
  13. ### Claude Code Plugin Marketplace
  14. ```bash
  15. /plugin marketplace add safaiyeh/app-store-review-skill
  16. /plugin install app-store-review@app-store-review
  17. ```
  18. ### skills.sh
  19. ```bash
  20. npx skills add safaiyeh/app-store-review-skill
  21. ```
  22. ## Setup
  23. ### Supported AI Agents
  24. This skill works with Codex and AI coding agents that support the skills.sh standard:
  25. - [Codex](https://openai.com/codex/)
  26. - [Claude Code](https://claude.ai/code)
  27. - [Cursor](https://cursor.sh)
  28. - [Windsurf](https://codeium.com/windsurf)
  29. - And other compatible agents
  30. ### How It Works
  31. 1. **Install the skill** in your project using the command above
  32. 2. **Start your AI agent** in the project directory
  33. 3. **Ask for an App Store review** - the agent will automatically load relevant guidelines
  34. 4. **Review the findings** - the agent identifies potential rejection issues with code references
  35. ### Example Prompts
  36. ```
  37. "Review this app for App Store compliance"
  38. "Check if my IAP implementation follows Apple's guidelines"
  39. "Audit the privacy and data collection in this React Native app"
  40. "What App Store issues might block my submission?"
  41. ```
  42. ### Telemetry
  43. The skills CLI collects anonymous usage telemetry. To opt out:
  44. ```bash
  45. SKILLS_NO_TELEMETRY=1 npx skills add safaiyeh/app-store-review-skill
  46. ```
  47. **This skill itself collects no telemetry** and makes no network calls of its own.
  48. ### Feedback
  49. All feedback is welcome, big or small: false positives, findings the skill missed, guidance that was too aggressive, too noisy, too vague, or outdated, wrong section citations, bad suggested fixes, missing coverage, or the skill triggering when it shouldn't. If anything felt off — especially if your app was rejected despite following the skill — please [file a feedback issue](https://github.com/safaiyeh/app-store-review-skill/issues/new?template=skill-feedback.yml).
  50. The skill also instructs your AI agent to *offer* to draft such an issue when it notices the skill failed you. This is strictly consent-based: the agent must ask first, show you the exact issue text, and only submit with your approval (via `gh`, which you can also deny at the permission prompt). It never sends anything automatically, and drafts never include your code or app details.
  51. ## Structure
  52. ```
  53. app-store-review-skill/
  54. ├── .agents/
  55. │ └── plugins/marketplace.json # Codex plugin marketplace
  56. ├── .claude-plugin/
  57. │ ├── marketplace.json # Claude Code plugin marketplace
  58. │ └── plugin.json # Claude Code plugin manifest
  59. ├── .codex-plugin/
  60. │ └── plugin.json # Codex plugin manifest
  61. ├── agents/
  62. │ └── openai.yaml # Codex UI metadata
  63. ├── SKILL.md # Index with quick reference & checklist
  64. └── rules/
  65. ├── 1-safety.md # Section 1: Safety guidelines
  66. ├── 2-performance.md # Section 2: Performance guidelines
  67. ├── 3-business.md # Section 3: Business guidelines
  68. ├── 4-design.md # Section 4: Design guidelines
  69. └── 5-legal.md # Section 5: Legal guidelines
  70. ```
  71. ## Coverage
  72. This skill covers **ALL 5 major sections** with **EVERY guideline point**:
  73. ### [1. Safety](rules/1-safety.md)
  74. - 1.1 Objectionable Content (1.1.1-1.1.7)
  75. - 1.2 User-Generated Content, AI Content Creation & Creator Content (including nonconsensual intimate imagery safeguards)
  76. - 1.3 Kids Category (parental gates, privacy, analytics)
  77. - 1.4 Physical Harm (medical apps, drug dosage, substances)
  78. - 1.5 Developer Information
  79. - 1.6 Data Security
  80. - 1.7 Reporting Criminal Activity
  81. ### [2. Performance](rules/2-performance.md)
  82. - 2.1 App Completeness (final versions, IAP)
  83. - 2.2 Beta Testing
  84. - 2.3 Accurate Metadata (2.3.1-2.3.14, including creative assets)
  85. - 2.4 Hardware Compatibility (2.4.1-2.4.5)
  86. - 2.5 Software Requirements (2.5.1-2.5.19, including hidden-feature enforcement)
  87. ### [3. Business](rules/3-business.md)
  88. - 3.1 Payments (IAP, subscriptions, regional purchase-link entitlements and permitted destinations, crypto)
  89. - 3.1.1-3.1.5 In-App Purchase rules
  90. - 3.2 Other Business Models (acceptable/unacceptable)
  91. ### [4. Design](rules/4-design.md)
  92. - 4.1 Copycats
  93. - 4.2 Minimum Functionality
  94. - 4.3 Spam
  95. - 4.4 Extensions (keyboard, Safari)
  96. - 4.5 Apple Sites and Services
  97. - 4.7 Mini Apps, Chatbots, Game Emulators
  98. - 4.8 Login Services
  99. - 4.9 Apple Pay
  100. - 4.10 Monetizing Built-In Capabilities
  101. ### [5. Legal](rules/5-legal.md)
  102. - Enforcement for human trafficking and child exploitation (App Store removal and alternative-distribution blocks)
  103. - 5.1 Privacy (data collection, use, sharing, health, kids, location)
  104. - 5.2 Intellectual Property
  105. - 5.3 Gaming, Gambling, Lotteries
  106. - 5.4 VPN Apps
  107. - 5.5 Mobile Device Management
  108. - 5.6 Developer Code of Conduct (reviews, developer identity, discovery fraud, app quality)
  109. ## Features
  110. - **Modular structure** - Agent loads only relevant sections
  111. - **2000+ lines** of comprehensive guidelines
  112. - **Checklists** for every guideline point
  113. - **Code patterns** for Swift AND React Native/Expo
  114. - **Package references** for both Expo and bare React Native
  115. - **Quick reference** for high-risk rejection patterns
  116. - **Pre-submission checklist** in main SKILL.md
  117. ## React Native / Expo Support
  118. Each rule file includes:
  119. - TypeScript/JavaScript code patterns to flag
  120. - Expo package recommendations (preferred)
  121. - Bare React Native package alternatives
  122. - React Native-specific checklists
  123. Key packages covered:
  124. - `react-native-purchases` (RevenueCat — recommended for IAP) / `react-native-iap`
  125. - `expo-tracking-transparency` / `react-native-tracking-transparency`
  126. - `expo-secure-store` / `react-native-keychain`
  127. - `expo-apple-authentication` / `@invertase/react-native-apple-authentication`
  128. - `expo-local-authentication` / `react-native-biometrics`
  129. ## What It Checks
  130. ### Critical Issues (Immediate Rejection)
  131. - Private API usage
  132. - Hardcoded secrets/credentials
  133. - External payment for digital goods where IAP is required
  134. - On-device cryptocurrency mining
  135. - Dynamic code execution
  136. - Hidden, dormant, or undocumented features concealed from App Review (2.5.19)
  137. ### High-Risk Issues
  138. - Missing App Tracking Transparency
  139. - Account creation without deletion
  140. - IAP without restore purchases
  141. - UGC or AI content creation without moderation, including safeguards against nonconsensual intimate imagery
  142. - UGC without removal workflows or a compliance improvement plan
  143. - UGC without a terms (EULA) agreement before sign-up/login, 24-hour report handling, or blocking that hides content immediately
  144. - Kids apps without parental gates
  145. - Live Activities or push notifications used for spam, phishing, or unsolicited messages
  146. ### Medium-Risk Issues
  147. - Vague purpose strings
  148. - Over-requesting permissions
  149. - Unjustified background modes
  150. - References to other platforms
  151. - "Free" or other pricing words in screenshots, including in-app UI text
  152. - Custom review prompts instead of the system API
  153. - Creative assets with inappropriate content, misleading app references, unverifiable claims, or specific/discounted pricing (2.3.14)
  154. ## When It Triggers
  155. The skill activates when working on:
  156. - App Store submission preparation
  157. - Code compliance review
  158. - Payment/StoreKit implementation
  159. - Privacy and data handling
  160. - User-generated content features
  161. - Kids Category apps
  162. - Health/medical apps
  163. - VPN/MDM apps
  164. - Gambling/lottery apps
  165. ## License
  166. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.