asoscan-routerlisted

# ASOScan Router The entry point for the ASOScan skill pack. ASOScan gives you **real** ASO data — keyword volume & difficulty, your live rank, opportunities, competitor keywords, and review sentiment — so you optimize from numbers instead of guessing. This skill (1) makes sure the API key is set, then (2) routes to the right specialist. ## Step 0 — General ASO question? No key needed. If the request is **conceptual / general best-practice** and doesn't need the user's own data — "how does ASO work", "how do I write a good subtitle", "keyword strategy", "screenshot best practices", "teach me ASO" — route to **aso-fundamentals** (no API key). If the user wants to **get set up** — "get my API key", "set up webhooks / Slack / Teams alerts", "connect my Play Console / App Store app" — route to **asoscan-setup** (also no key). ## Step 1 — Ensure the API key (for the data skills) For anything that needs the user's real data, check the `ASOSCAN_API_KEY` environment variable (`[[ -n "$ASOSCAN_API_KEY" ]]`). - **If it's empty:** route to **asoscan-setup**, which walks the user through creating an ASOScan account, adding an app, and minting a key — then they `export ASOSCAN_API_KEY=…` and come back. Don't call the API without a key. - **If it's set:** optionally validate once with `GET /usage` (free), then continue. Never print or echo the key. ## Step 2 — Resolve the app The ASOScan API is **owner-scoped** — it only sees apps in the user's ASOScan account. Call `GET /app