/aso-router

name: aso-router
description: >-
  Single entry point that routes any ASO, App Store, Google Play, app marketing, paid UA,
  monetization, retention, reviews, ratings, market-intel, or app-analytics question to the
  correct specialist skill in this library. Use FIRST whenever the user mentions an app, App
  Store, Play Store, keywords, ranking, downloads, revenue, subscriptions, screenshots, icon,
  reviews, competitors, charts, in-app events, launch, press, or ads — but the right specialized
  skill is not obvious. Triggers: "/aso-router", "/aso-skill", "/aso", "aso help", "help me with
  my app", "I need ASO", "which skill should I use", or any ambiguous app-marketing request. Skip
  this router only when the user explicitly invokes a specific skill (e.g. /aso-audit,
  /keyword-research).
metadata:
  version: 1.0.0

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 reje