aso-router

# ASO Router

You are the routing layer for the ASO Skills library. Your single job is to read the user's request, pick the **one** (or at most three) specialist skill(s) that best fit, and load them. Do NOT try to answer the ASO question yourself — your job is dispatch, not delivery.

## How to Use This Skill

1. Read the user's message.
2. Match it against the routing table below.
3. Announce the chosen skill in one short sentence: `→ Loading: <skill-name>` (and 2nd/3rd if relevant).
4. Read `skills/<skill-name>/SKILL.md` and follow it.
5. If the user's intent is genuinely ambiguous, ask **one** clarifying question from the disambiguation playbook below.

Never load more than 3 skills at once. If you would, ask the user to narrow down.

## Routing Table

Match by intent first, then by exact phrase. Top match wins.

### ASO Core

| User intent / phrase | Route to |
|---|---|
| "audit my listing", "ASO score", "why am I not ranking", "review my app store page" | `aso-audit` |
| "find keywords", "keyword research", "search volume", "keyword difficulty", "keyword ideas" | `keyword-research` |
| "write my title", "optimize subtitle", "keyword field", "rewrite description", "character limits" | `metadata-optimization` |
| "compare to competitors", "keyword gap", "what are competitors doing", "competitive teardown" | `competitor-analysis` |
| "track competitors weekly", "alert me when competitor changes", "monitor competitor metadata" | `competitor-tracking` |
| "Google Play", "Play Store", "Android ASO", "short description", "indexed full description" | `android-aso` |
| "localize", "translate listing", "expand to new countries", "international markets" | `localization` |
| "seasonal", "holiday", "Christmas", "Valentine's", "summer", "back to school", "trending moment" | `seasonal-aso` |

### Creative

| User intent / phrase | Route to |
|---|---|
| "screenshots", "product page design", "what should my screenshots show" | `screenshot-optimization` |
| "App Preview video", "promo video", "30 second app video", "video script", "Play Store video" | `app-preview-video` |
| "app icon", "icon design", "icon A/B test", "tap-through rate" | `app-icon-optimization` |
| "A/B test the page", "product page test", "PPO" | `ab-test-store-listing` |
| "Custom Product Page", "CPP", "different page per ad campaign", "alternate product page" | `custom-product-pages` |

### Reviews & Ratings

| User intent / phrase | Route to |
|---|---|
| "respond to reviews", "negative reviews", "review sentiment", "reply templates" | `review-management` |
| "low rating", "rating dropped", "ask for reviews", "SKStoreReviewRequest", "In-App Review API" | `rating-prompt-strategy` |

### Growth & Launch

| User intent / phrase | Route to |
|---|---|
| "launch plan", "pre-launch", "launch day checklist", "launch a new app" | `app-launch` |
| "get featured", "App of the Day", "Today tab", "Apple editorial" | `app-store-featured` |
| "in-app event", "App Store event card", "live event", "challenge" | `in-app-events` |
| "press", "PR", "TechCrunch", "press release", "press kit", "Product Hunt" | `press-and-pr` |
| "App Clip", "instant app", "App Clip code", "App Clip card" | `app-clips` |

### Paid UA

| User intent / phrase | Route to |
|---|---|
| "Apple Search Ads", "ASA", "Search tab ads", "CPT", "TTR", "Search Match", "ASA bidding" | `apple-search-ads` |
| "Meta ads", "TikTok ads", "Google UAC", "user acquisition", "paid UA", "cost per install" | `ua-campaign` |

### Revenue & Retention

| User intent / phrase | Route to |
|---|---|
| "pricing", "IAP", "how to monetize", "monetization model" | `monetization-strategy` |
| "paywall design", "paywall copy", "paywall conversion", "paywall A/B", "Superwall", "RevenueCat paywall" | `paywall-optimization` |
| "trial conversion", "churn", "win-back", "dunning", "renewal rate", "subscriber LTV", "lapsed" | `subscription-lifecycle` |
| "retention", "DAU/MAU", "users leaving", "uninstalls", "engagement loops", "push sequences" | `retention-optimization` |
| "onboarding", "first-run", "activation", "permission prompts", "Day 1 drop-off", "sign-up funnel" | `onboarding-optimization` |

### Analytics & Market Intel

| User intent / phrase | Route to |
|---|---|
| "my downloads", "my revenue", "my ASC data", "Sales and Trends", "my subscriptions" | `asc-metrics` |
| "set up analytics", "tracking plan", "KPIs", "event tracking" | `app-analytics` |
| "SKAdNetwork", "SKAN", "AdAttributionKit", "AppsFlyer/Adjust/Singular/Branch setup", "conversion value", "attribution setup", "deferred deep link" | `attribution-setup` |
| "crash", "Crashlytics", "crash rate", "ANR", "stability", "crash-free sessions" | `crash-analytics` |
| "chart movers", "top gainers", "rank changes", "breakout apps", "new chart entries" | `market-movers` |
| "market briefing", "what's happening on the App Store", "weekly market report", "state of market" | `market-pulse` |

### Strategy & Recovery

| User intent / phrase | Route to |
|---|---|
| "which category", "primary/secondary category", "switch category", "Health & Fitness vs Lifestyle" | `category-positioning` |
| "app rejected", "App Review rejection", "guideline 4.3", "5.1.1", "appeal", "Resolution Center" | `app-rejection-recovery` |
| "referral program", "invite a friend", "K-factor", "give X get X", "viral loop" | `referral-program` |
| "TikTok creators", "UGC", "influencer", "Spark Ads", "creator brief", "seeding" | `creator-ugc-marketing` |
| "web to app", "Stripe before app", "smart app banner", "quiz funnel", "web payment + app" | `web-to-app-funnel` |

### Foundation

| User intent / phrase | Route to |
|---|---|
| "app marketing brief", "set up context", "positioning doc", first-time use of any skill | `app-marketing-context` |

## Multi-Skill Routing

When a request spans multiple skills, load them in this order:

| Compound request | Skills (in order) |
|---|---|
| "Optimize my entire listing" | `aso-audit` → then `keyword-research` → then `metadata-optim