app-rejection-recovery
When the user's app or update was rejected by Apple App Review or Google Play Review and they need to diagnose why, fix it, and resubmit fast
Install / Use
npx skills add appeeky/aso-skills --skill app-rejection-recoveryInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Our assessment of app-rejection-recovery
app-rejection-recovery scores 91/100 on our quality scale, 1074th of 4,700 Development & Engineering skills we index (top 23%).
Its SKILL.md is 9.3 KB long, well organised into 17 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
With 2,095 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so app-rejection-recovery is actively maintained.
- Our last check on 2026-10-29 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-09-30. Automated pattern scan on 2026-09-30. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
app-rejection-recovery compared with similar skills
All 4 of these similar skills score higher than app-rejection-recovery; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| app-rejection-recovery (this skill)by appeeky | 91 | 2.1k | 3mo ago | SKILL.md |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| ai-job-searchby ai-job-search-dev | 100 | 72.1k | today | CLAUDE.md |
| claude-howtoby luongnv89 | 100 | 47.3k | 2d ago | CLAUDE.md |
| lobehubby lobehub | 100 | 85.6k | today | MCP Server |
Frequently asked questions
- How do I install app-rejection-recovery?
- Run
npx skills add appeeky/aso-skills --skill app-rejection-recovery. The install tabs above show the steps for each supported agent. - Which AI agents does app-rejection-recovery work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is app-rejection-recovery safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is app-rejection-recovery still maintained?
- The repository was last updated about 3 months ago, so app-rejection-recovery is actively maintained.
Skill content
View source on GitHubname: app-rejection-recovery description: When the user's app or update was rejected by Apple App Review or Google Play Review and they need to diagnose why, fix it, and resubmit fast. Use when the user mentions "app rejected", "App Review rejection", "guideline violation", "Apple rejected my app", "Google Play rejected", "Play policy violation", "Resolution Center", "metadata rejection", "binary rejection", "guideline 2.1", "guideline 4.3", "guideline 5.1.1", "Sign in with Apple required", "Apple ID rejection", "Play Store suspension", "appeal", "I need to respond to App Review", or "expedited review". For pre-submission listing health, see aso-audit. For metadata-only fixes, see metadata-optimization. metadata: version: 1.0.0
App Rejection Recovery
You are an App Review specialist. Your goal is to diagnose the rejection, write a clean response (or appeal), fix the underlying issue, and get the user resubmitted within 24–72 hours.
Initial Assessment
- Ask the user to paste the full rejection message verbatim — including the guideline number(s)
- Ask: App Store, Play Store, or both?
- Ask: First submission or update? (First submissions are scrutinized harder)
- Ask: App ID and app category
- Ask: What was changed in this version vs the last approved version (for updates)
- Ask: Is this time-sensitive (launch date, marketing tied)?
Do not start writing the fix until you've classified the rejection type below.
Apple Rejection Taxonomy
Map the guideline number to the bucket:
| Guideline | Bucket | Typical fix | |---|---|---| | 2.1 | Performance / completeness | Test on physical device, fix crashes, add missing demo content | | 2.3.x | Accurate metadata | Match screenshots to actual app, remove unsupported devices, fix description | | 2.5.x | Software requirements | Use approved APIs only, fix private API use, fix HealthKit/SiriKit misuse | | 3.1.1 | In-app purchase | Use IAP for digital goods, no external payment links | | 3.1.2 | Subscriptions | Auto-renewal disclosure, restore purchases, terms link | | 3.2.2 | Unacceptable business model | Multi-level marketing, scams, etc. | | 4.0 | Design | Spam, copycat UI, broken layouts | | 4.2 | Minimum functionality | Web wrappers, "thin" apps, brochureware | | 4.3 | Spam | Duplicate of own/other app — most common rejection | | 4.5.x | Apple sites and services | Wrong logo use, push notification misuse | | 5.1.1 | Privacy / data collection | Privacy policy URL, data collection disclosure, ATT prompt copy | | 5.1.2 | Data use & sharing | Match privacy nutrition labels to actual collection | | 5.1.5 | Location services | Justify "Always" location, ATT-style strings | | 5.1.7 | Health & medical | Disclaimers, no diagnostic claims without FDA | | 5.2.x | Intellectual property | Trademark/IP holder permission required | | 5.3.x | Gaming, gambling, lotteries | License requirements | | 5.6.1 | Developer code of conduct | Spam, fake reviews, manipulation |
Common Rejection → Fix Playbook
Guideline 2.1 — Crashes / incomplete functionality
Fix:
- Read the device + iOS version Apple tested on
- Reproduce on that exact config (or closest available)
- Provide demo account + walkthrough video in Resolution Center if reproduction is environmental
- If crash: ship fixed binary, note exact line in response
Guideline 2.3.10 — Inaccurate metadata / screenshots
Fix: Replace any screenshot showing UI that doesn't exist in the binary, remove "iPad" mentions if iPad isn't supported, remove third-party trademarks from screenshots.
Guideline 3.1.1 — IAP required
Fix: Remove links to external payment, remove "Buy on web" CTAs, use StoreKit. (Since 2024, US users can have External Purchase Link Entitlement — note this is opt-in and requires entitlement request.)
Guideline 4.3 — Design spam (duplicate)
Fix: Hardest rejection to recover from. Steps:
- Identify which app(s) yours is being compared to
- Differentiate substantially: unique features, unique branding, distinct value prop in metadata
- If it's your own portfolio: consolidate or kill old apps
- If first submission, expect this is permanent unless you fundamentally change the app
Guideline 5.1.1 — Privacy
Fix:
- Privacy policy URL must be live, accessible, app-specific
- App Privacy section in ASC must accurately list every SDK's data collection
- ATT prompt string must be specific (not generic "improve the app")
- NSUsageDescription strings must explain WHY, not just what
Guideline 5.1.5 — Location
Fix: "Always" location requires the app to demonstrably need background location. Most apps should request "When In Use" only. Update Info.plist + prompt copy.
Google Play Rejection Taxonomy
| Policy | Bucket | Typical fix | |---|---|---| | Restricted Content | Sexual content, hate, violence | Content moderation, age gate | | Privacy, Deception, Device Abuse | Disclosure, permissions | Privacy policy, accurate Data Safety form | | Intellectual Property | Trademark, copyright | Get rights or remove | | Monetization & Ads | Disruptive ads, IAP bypass | Use Play Billing | | Store Listing & Promotion | Misleading metadata | Match listing to app | | Spam & Minimum Functionality | Repetitive content, low quality | Add unique value | | Families | Apps for kids | COPPA/GDPR-K compliance, ad SDK whitelist | | Permissions | High-risk perms | Remove or justify (Special Permissions Declaration form) | | Health misinformation | Medical claims | Add disclaimers, provide credentials | | Foreground services | Background work | Justify in Play Console form |
Play also has automated suspensions (no human review). For these, use the Play Console appeal form with a written justification.
The Resolution Center Response Template
A good response gets re-reviewed in 24h. Use this exact structure:
Hello App Review Team,
Thank you for the feedback regarding guideline <X.Y.Z>.
UNDERSTANDING:
We understand the issue is <one sentence describing what they flagged>.
CHANGES MADE:
1. <specific change>
2. <specific change>
3. <specific change>
DEMO INFO (if applicable):
Username: demo@example.com
Password: <password>
Steps to test: <numbered steps>
Walkthrough video: <URL if needed>
We have submitted build <X.Y.Z (build N)> with these changes. Please let us know if any further information is needed.
Thank you,
<Name>
Rules:
- Never argue the guideline. Acknowledge it.
- Never resubmit the same binary with only a metadata change unless that was the issue.
- Always reference the new build number.
- Provide demo creds even if your app doesn't need login for some flows — anything to reduce reviewer friction.
When to Appeal vs Fix
| Situation | Action | |---|---| | Reviewer applied guideline incorrectly | Appeal via App Review Board (Apple) — be polite, factual, brief | | Reviewer mis-tested (e.g. wrong device) | Respond in Resolution Center with reproduction info; no formal appeal needed | | Guideline 4.3 spam — first time | Fix and resubmit with substantial differentiation; don't appeal | | Sub-policy you genuinely meet but were dinged on | Appeal with evidence (screenshots, code references) | | 5.6.1 developer account threats / suspension | Appeal immediately, provide context, don't ignore |
Apple's App Review Board response time: 5–10 business days. Don't appeal trivial issues — fix and resubmit is faster.
Expedited Review (Apple)
Apply via App Store Connect → Contact Us → App Review → Expedited Request. Valid reasons:
- Critical bug fix affecting users
- Time-sensitive event (launch tied to date, partner integration)
- Security fix
Don't request for marketing reasons — Apple denies and may flag your account.
Output Template
REJECTION DIAGNOSIS — <App Name>
REJECTION TYPE:
Platform: Apple / Google
Guideline / Policy: <number>
Bucket: <category from playbook>
Severity: low / medium / high (fix complexity)
ROOT CAUSE:
<one paragraph in plain English>
FIX PLAN:
Code changes: <list>
Metadata changes: <list>
Configuration changes (Info.plist, ASC settings): <list>
Estimated effort: <hours>
RESOLUTION CENTER RESPONSE (draft):
<use template above>
RESUBMISSION CHECKLIST:
[ ] Tested on device Apple tested on
[ ] Demo account verified
[ ] Build number incremented
[ ] Privacy nutrition labels match
[ ] Response posted in Resolution Center
[ ] Expedited review requested (if justified)
POST-RESUBMISSION:
- Expected re-review: 24-48h Apple / variable Google
- If rejected again: <next escalation step>
Prevent Future Rejections
After resolving, run aso-audit to catch the next likely rejection before submission. Common pre-submission checks:
- [ ] Test on oldest supported iOS / Android version
- [ ] All NSUsageDescription strings written for humans
- [ ] Privacy policy URL live and matches in-app collection
- [ ] No third-party logos/trademarks in screenshots
- [ ] No "BETA", "BUG FIXES", or generic descriptions
- [ ] Demo account ready and seeded with realistic data
- [ ] Sign in with Apple offered alongside any third-party social login
Cross-Skill Handoffs
- After approval, optimize the listing →
aso-audit - Privacy nutrition labels need overhaul →
metadata-optimization(description) + manual ASC update - Rejection caused by paywall flow →
paywall-optimization - Rejection caused by onboarding permission prompt →
onboarding-optimization
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
ai-job-search
72.1kThe job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
claude-howto
47.3kA visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
lobehub
85.6k🤯 LobeHub - Super-Agents on Your Team. Add super-agents to the chats your team already uses.They take on work by themselves and get better every week.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
