| name | aso-compliance |
| description | Store policy compliance checker for iOS App Store and Google Play. Validates metadata against Apple App Store Review Guidelines and Google Play Developer Program Policies. Catches violations that would cause rejection. Also validates ASO recommendations from other agents. Triggers on: "compliance", "policy check", "guidelines", "store policies", "review guidelines", "will this get rejected", "is this allowed".
|
| user-invokable | true |
| argument-hint | [app-id] [--platform ios|android] |
ASO Compliance — Store Policy Checker
Validates app metadata against Apple App Store Review Guidelines and Google Play Developer Program Policies. Catches violations before they cause rejection.
Two Modes
- Standalone:
/aso compliance or /aso compliance <app-id> — check current metadata
- Audit integration: Runs automatically as part of
/aso audit after all agents return, validating both current metadata AND recommended changes
Process
Step 1: Get Metadata
Same as other skills — local detection or remote fetch:
uv run python scripts/detect_project.py --json
uv run python scripts/fetch_listing.py <id> --json
Step 2: Load Policy Reference
Read references/store-policies.md for the complete rule set covering:
- Title restrictions and banned words
- Description content prohibitions
- Keyword spam rules
- Screenshot requirements
- Pricing/IAP disclosure rules
- Health/medical claim restrictions
- Financial claim restrictions
- Review manipulation rules
- AI content policies
- Intellectual property rules
Step 3: Run Compliance Checks
For each metadata field, check against every applicable rule for the detected platform.
Title checks:
- Banned words present? (Google: "#1", "best", "top", "free", "download now", etc.)
- Competitor brand names?
- Trademarked terms without license?
- ALL CAPS? (Google: prohibited unless registered brand)
- Emojis? (Google: prohibited in title)
- Other platform names? (Apple: no "Android")
- Pricing language?
Description checks:
- Testimonials? (Google: prohibited)
- Rating/performance claims? ("4.9 stars", "million downloads")
- Pricing info? ("$X off", "free trial", "limited time")
- Call-to-actions? (Google: "download now", "install now")
- Competitor names?
- Keyword stuffing? (unnatural density)
- Misleading functionality claims?
Category-specific checks:
- Health apps: disclaimers present? No unvalidated measurement claims?
- Finance apps: APR disclosed? Financial features declaration done?
- AI apps: data sharing disclosed? In-app reporting?
- Gaming: loot box odds disclosed? IAP transparent?
IAP/pricing checks:
- If app has IAP: disclosed in description and screenshots?
- If "free": any essential features behind paywall?
- Subscription terms clear?
Screenshot checks (if descriptions/captions available):
- Promotional text present? ("#1", "Best", "Sale")
- Ranking claims?
- Non-app UI elements?
Step 4: Report
Severity levels:
| Level | Meaning | Icon |
|---|
| VIOLATION | Will likely cause rejection | Must fix |
| RISK | May trigger review or penalty | Should fix |
| ADVISORY | Best practice recommendation | Consider |
Output format:
## Compliance Report: [App Name]
**Platform**: [iOS / Android / Both]
**Result**: [X violations, Y risks, Z advisories]
**Compliance Score**: XX/100
### Violations (Must Fix)
| # | Field | Rule | Issue | Fix |
|---|-------|------|-------|-----|
| 1 | title | Google Banned Words | Contains "#1" | Remove and use descriptive keyword |
### Risks (Should Fix)
| # | Field | Rule | Issue | Fix |
|---|-------|------|-------|-----|
### Advisories (Consider)
| # | Field | Rule | Issue | Fix |
|---|-------|------|-------|-----|
### Recommendation Flags
[If running as part of audit — list any agent recommendations that violate policies]
| Source | Recommendation | Violation | Alternative |
|--------|---------------|-----------|-------------|
When Running as Part of Audit
The compliance agent runs AFTER all other agents return (Step 3.5 in audit flow). It receives:
- Current metadata (same as other agents)
- Recommendations from all agents (title rewrites, keyword suggestions, description changes)
It validates ALL recommendations against store policies. Any violating recommendation is:
- Flagged in the compliance report
- Removed from the final ASO-ACTION-PLAN.md
- Replaced with a compliant alternative where possible
This ensures the audit NEVER recommends metadata that would get the app rejected.
Available Tools
Read, Bash, Write, Glob, Grep
