aso-router
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).
- Installs
- 295
- Last 24h
- +16
- Trending rank
- #6904
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/appeeky/aso-skills --skill aso-router- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads aso-router automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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
- Read the user's message.
- Match it against the routing table below.
- Announce the chosen skill in one short sentence:
→ Loading: <skill-name>(and 2nd/3rd if relevant). - Read
skills/<skill-name>/SKILL.mdand follow it. - 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-optimization |
| "Launch a new app" | app-marketing-context → app-launch → aso-audit |
| "I want more downloads" | aso-audit first; if paid, also ua-campaign |
| "My revenue is flat" | asc-metrics → monetization-strategy → subscription-lifecycle |
| "I'm getting bad reviews" | review-management + rating-prompt-strategy; if root cause is product, add crash-analytics or onboarding-optimization |
| "Beat my competitor" | competitor-analysis → keyword-research → metadata-optimization |
| "Holiday push" | seasonal-aso → metadata-optimization → in-app-events |
| "Expand to Germany/Japan/etc." | localization → keyword-research (per country) → metadata-optimization |
| "Launch with paid + creator" | app-launch → creator-ugc-marketing → ua-campaign → attribution-setup |
| "Increase paid sub conversion" | paywall-optimization → subscription-lifecycle |
| "App got rejected" | app-rejection-recovery (then post-fix: aso-audit) |
| "Build a quiz funnel for my app" | web-to-app-funnel → attribution-setup → paywall-optimization (in-app fallback) |
| "Pick the right App Store category" | category-positioning → aso-audit |
| "Run ads with different landing pages" | custom-product-pages → apple-search-ads (and/or ua-campaign) |
Disambiguation Playbook
When intent is unclear, ask one of these questions — never more.
| Signal | Question |
|---|---|
| Mentions "optimize app" but not what | "Are you optimizing for search ranking (ASO), conversion (icon/screenshots), revenue (paywall), or retention?" |
| Mentions "more users" | "Do you want organic (ASO) or paid (UA) growth — or both?" |
| Mentions "fix my app" | "Is the issue discoverability, conversion on the page, bad reviews, or churn after install?" |
| Mentions a competitor by name | "One-time deep teardown (competitor-analysis) or ongoing weekly tracking (competitor-tracking)?" |
| Mentions "Apple Search Ads" + "Meta/TikTok" | "Want to focus on Apple Search Ads only (apple-search-ads) or all paid channels (ua-campaign)?" |
| Mentions "subscription" | "Are you working on paywall/pricing design (monetization-strategy) or lifecycle/churn (subscription-lifecycle)?" |
| Mentions "ratings" | "Do you want to respond to existing reviews (review-management) or prompt more new ratings (rating-prompt-strategy)?" |
Routing Anti-Patterns
Do not route to:
aso-auditfor keyword discovery — usekeyword-research.metadata-optimizationfor keyword discovery — it implements, doesn't research.app-launchfor ongoing ASO — only for new app or major version launches.ua-campaignfor Apple Search Ads deep dives — useapple-search-ads.monetization-strategyfor trial/churn lifecycle — usesubscription-lifecycle.app-analyticsfor the user's own ASC data — useasc-metrics.
Output Template
When you route, format your handoff like this:
→ Routing to: <skill-name>
Why: <one-line reason>
(Optional follow-ups: <skill-2>, <skill-3>)
[Then load and follow skills/<skill-name>/SKILL.md]
If you needed to ask a clarifying question first, ask it before the routing block.
Context Check
Before routing into any skill except app-marketing-context, check whether app-marketing-context.md exists in the workspace. If it doesn't and the requested skill needs app context (almost all do), suggest:
"Quick win: I can set up an app-marketing-context doc first (~2 min) so every future skill has your app, audience, competitors, and goals on hand. Want me to?"
Only suggest this once per session.
When NOT to Use This Skill
If the user explicitly invokes a specific skill (/keyword-research, /aso-audit, etc.), skip this router and go straight to the requested skill. The router is for ambiguous, natural-language requests only.
FAQ
What does the aso-router skill do?
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).
How do I install aso-router?
Run npx skills add https://github.com/appeeky/aso-skills --skill aso-router in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/aso-router/ (personal) or .claude/skills/aso-router/ (project).
Which AI agents can use aso-router?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is aso-router safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains aso-router?
It is published by appeeky in appeeky/aso-skills. It has 295 recorded installs.
More from appeeky/aso-skills
aso-audit
appeeky/aso-skills
When the user wants a full ASO health audit, review their App Store listing quality, or diagnose why their app isn't ranking. Also use when the user mentions "ASO audit", "ASO score", "why am I not ranking", "listing review", or "optimize my app store page". For keyword-specific research, see keyword-research. For metadata writing, see metadata-optimization.
keyword-research
appeeky/aso-skills
When the user wants to discover, evaluate, or prioritize App Store keywords. Also use when the user mentions "keyword research", "find keywords", "search volume", "keyword difficulty", "keyword ideas", or "what keywords should I target". For implementing keywords into metadata, see metadata-optimization. For auditing current keyword performance, see aso-audit.
monetization-strategy
appeeky/aso-skills
When the user wants to design or optimize their app's monetization — pricing, paywalls, subscriptions, or in-app purchases. Also use when the user mentions "pricing", "paywall", "subscription", "IAP", "how to monetize", "revenue optimization", "free trial", or "conversion to paid". For retention impact, see retention-optimization. For competitive pricing, see competitor-analysis.
metadata-optimization
appeeky/aso-skills
When the user wants to optimize App Store metadata — title, subtitle, keyword field, or description. Also use when the user mentions "optimize my title", "ASO metadata", "keyword field", "character limits", "app description", or "write my subtitle". For keyword discovery, see keyword-research. For full ASO audits, see aso-audit.
competitor-analysis
appeeky/aso-skills
When the user wants to analyze competitors' App Store strategy, find keyword gaps, or understand competitive positioning. Also use when the user mentions "competitor analysis", "competitive research", "keyword gap", "what are my competitors doing", or "compare my app to". For keyword-specific research, see keyword-research. For metadata writing, see metadata-optimization.
screenshot-optimization
appeeky/aso-skills
When the user wants to design, optimize, or evaluate App Store screenshots and preview videos. Also use when the user mentions "screenshots", "app preview", "product page design", "screenshot design", "creative assets", or "what should my screenshots show". For A/B testing screenshots, see ab-test-store-listing. For full ASO audit, see aso-audit.
Popular marketing & seo skills
reddit-automation
flowkit-labs/skills
Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.
twitter-automation
101-skills/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
twitter-automation
magentosh/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
twitter-automation
qu-skills/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
product-launch-video
heygen-com/hyperframes
Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.
twitter-automation
skills-shell/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet