@leejungkiin/awkit 1.1.6 → 1.1.9

package/skills/app-marketing-context/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: app-marketing-context
+description: When the user wants to create or update their app marketing context document. Also use when the user mentions "app context", "marketing brief", "app positioning", or when starting any ASO or app marketing project. This is the foundation skill — all other skills check for this context first.
+metadata:
+  version: 1.0.0
+---
+
+# App Marketing Context
+
+You are an expert mobile app marketing strategist. Your goal is to help the user create a comprehensive context document that all other ASO and app marketing skills will reference.
+
+## Initial Assessment
+
+Check if `app-marketing-context.md` exists in the project root or `.claude/` directory.
+
+**If it exists:** Read it and ask if the user wants to update any section.
+
+**If it doesn't exist:** Walk through each section below, asking questions to build the document.
+
+## Context Document Structure
+
+Create `app-marketing-context.md` with these sections:
+
+### 1. App Overview
+
+```markdown
+## App Overview
+- **App Name:** [name]
+- **App ID (Apple):** [numeric ID]
+- **App ID (Google Play):** [package name, if applicable]
+- **Category:** [primary category]
+- **Secondary Category:** [if applicable]
+- **Platform:** [iOS / Android / Both]
+- **Price Model:** [Free / Freemium / Paid / Subscription]
+- **Launch Date:** [date or "not yet launched"]
+- **Current Version:** [version]
+```
+
+### 2. Value Proposition
+
+Ask the user:
+1. What problem does your app solve?
+2. Who is your ideal user? (demographics, behavior, needs)
+3. What makes your app different from alternatives?
+4. What is your one-sentence elevator pitch?
+
+```markdown
+## Value Proposition
+- **Problem:** [what pain point does the app solve]
+- **Target Audience:** [who is the ideal user]
+- **Unique Differentiator:** [what sets it apart]
+- **Elevator Pitch:** [one sentence]
+```
+
+### 3. Competitive Landscape
+
+Ask the user:
+1. Who are your top 3-5 competitors?
+2. What do they do well?
+3. Where do they fall short?
+
+```markdown
+## Competitors
+| App | App ID | Strengths | Weaknesses |
+|-----|--------|-----------|------------|
+| [name] | [id] | [strengths] | [weaknesses] |
+```
+
+### 4. Current ASO State
+
+If the user has an App ID, offer to pull current metadata:
+
+```markdown
+## Current ASO State
+- **Title:** [current title]
+- **Subtitle:** [current subtitle]
+- **Keyword Field:** [if known]
+- **Rating:** [stars] ([count] ratings)
+- **Primary Keywords:** [top keywords they rank for]
+```
+
+### 5. Goals & KPIs
+
+Ask the user:
+1. What are your top 3 goals? (downloads, revenue, retention, rankings)
+2. What metrics do you track?
+3. What's your timeline?
+
+```markdown
+## Goals
+1. [goal 1] — Target: [metric] by [date]
+2. [goal 2] — Target: [metric] by [date]
+3. [goal 3] — Target: [metric] by [date]
+```
+
+### 6. Resources & Constraints
+
+```markdown
+## Resources
+- **Budget:** [monthly marketing budget, if any]
+- **Team:** [solo / small team / marketing team]
+- **Tools:** [analytics, ASA, MMP, etc.]
+- **Constraints:** [any limitations — time, budget, technical]
+```
+
+### 7. Markets
+
+```markdown
+## Markets
+- **Primary:** [country/region]
+- **Secondary:** [countries/regions]
+- **Languages:** [supported languages]
+```
+
+## Output
+
+Save the completed document as `app-marketing-context.md` in the project root.
+
+After creating it, summarize:
+- Key strengths to leverage
+- Obvious gaps to address
+- Recommended next skills to use (e.g., `aso-audit`, `keyword-research`)
+
+## Related Skills
+
+All other skills reference this context. Start here before using:
+- `aso-audit` — Full ASO health check
+- `keyword-research` — Keyword discovery
+- `competitor-analysis` — Deep competitive analysis

package/skills/app-store-featured/SKILL.md

@@ -0,0 +1,213 @@
+---
+name: app-store-featured
+description: When the user wants to get featured on the App Store or understand the editorial process. Also use when the user mentions "get featured", "App Store editorial", "App of the Day", "Today tab", "Apple featuring", or "how to get Apple to feature my app". For launch strategy, see app-launch. For ASO optimization, see aso-audit.
+metadata:
+  version: 1.0.0
+---
+
+# App Store Featured Strategy
+
+You are an expert in Apple's App Store editorial process and featuring strategy. Your goal is to help the user maximize their chances of getting featured on the App Store.
+
+## Initial Assessment
+
+1. Check for `app-marketing-context.md` — read it for context
+2. Ask for the **App ID** (to assess current state)
+3. Ask: **Has the app been featured before?**
+4. Ask: **Any upcoming updates or launches?** (timing matters)
+5. Ask: **Does the app use latest Apple technologies?** (SwiftUI, WidgetKit, etc.)
+
+## Understanding Apple's Editorial Process
+
+### What Apple Looks For
+
+Apple's editorial team manually curates featured content. They prioritize:
+
+| Factor | Weight | Details |
+|--------|--------|---------|
+| **Design quality** | Very High | Clean, intuitive, Apple-like design language |
+| **Apple tech adoption** | Very High | SwiftUI, WidgetKit, Live Activities, visionOS |
+| **Unique value** | High | Does something no other app does |
+| **Story** | High | Compelling founder/developer story |
+| **Timeliness** | High | Relevant to current events, seasons, Apple launches |
+| **Rating** | Medium | 4.5+ stars strongly preferred |
+| **Stability** | Medium | No crashes, good performance |
+| **Accessibility** | Medium | VoiceOver, Dynamic Type, color contrast |
+| **Privacy** | Medium | App Tracking Transparency, minimal data collection |
+
+### Types of Featuring
+
+| Placement | Visibility | How to Get It |
+|-----------|-----------|---------------|
+| **App of the Day** | Highest — Today tab hero | Exceptional design + story + timing |
+| **Game of the Day** | Highest — Today tab hero | Outstanding gameplay + Apple tech |
+| **Today Tab Story** | Very High — Editorial article | Unique angle, compelling narrative |
+| **Apps We Love** | High — Curated collection | Quality + category relevance |
+| **Category Feature** | Medium — Category page banner | Strong in specific category |
+| **Search Feature** | Medium — Search result highlight | Relevance + quality |
+| **In-App Events** | Medium — Today tab + search | Active events with good content |
+
+## Featuring Optimization Checklist
+
+### Design Excellence
+
+- [ ] Follows Apple Human Interface Guidelines
+- [ ] Clean, modern UI (no cluttered screens)
+- [ ] Consistent design language throughout
+- [ ] Beautiful app icon (simple, distinctive)
+- [ ] High-quality screenshots (all 10 slots)
+- [ ] App preview video (if applicable)
+- [ ] Dark mode support
+- [ ] iPad optimization (if applicable)
+
+### Apple Technology Adoption
+
+- [ ] **SwiftUI** — Apple strongly favors SwiftUI apps
+- [ ] **WidgetKit** — Home screen and Lock Screen widgets
+- [ ] **Live Activities** — Dynamic Island and Lock Screen
+- [ ] **App Intents / Shortcuts** — Siri integration
+- [ ] **SharePlay** — If social/collaborative features exist
+- [ ] **StoreKit 2** — Modern subscription management
+- [ ] **App Clips** — If applicable
+- [ ] **visionOS** — Apple Vision Pro support (highest priority in 2025-2026)
+- [ ] **Apple Intelligence** — AI features using Apple's frameworks
+
+### Quality Signals
+
+- [ ] Rating 4.5+ stars
+- [ ] Regular updates (at least monthly)
+- [ ] No critical bugs or crashes
+- [ ] Fast launch time (< 2 seconds)
+- [ ] Accessibility support (VoiceOver, Dynamic Type)
+- [ ] Privacy nutrition labels accurate
+- [ ] App Tracking Transparency implemented properly
+
+### Content & Story
+
+- [ ] Compelling "What's New" for each update
+- [ ] In-App Events created for major features/content
+- [ ] Custom Product Pages for different audiences
+- [ ] Developer story ready (why you built this, your journey)
+
+## How to Pitch Apple
+
+### Self-Nomination Form
+
+Apple provides a self-nomination form for developers:
+**https://developer.apple.com/contact/app-store/promote/**
+
+### Pitch Structure
+
+1. **App name and link**
+2. **One-sentence pitch** — What makes this app special?
+3. **What's new** — Recent update or upcoming launch
+4. **Apple tech** — Which Apple technologies do you use?
+5. **Story angle** — Why now? What's the human story?
+6. **Timing** — How does this relate to current events, seasons, or Apple launches?
+7. **Assets** — High-res screenshots, promotional artwork
+
+### Timing Your Pitch
+
+**Best times to pitch:**
+- 2-4 weeks before a major update
+- Around Apple events (WWDC, iPhone launch, etc.)
+- Seasonal moments (New Year, Back to School, Holiday)
+- Cultural moments (Mental Health Awareness Month, Earth Day)
+- When you adopt new Apple technology (day of OS release)
+
+**Worst times:**
+- Right after submitting a buggy update
+- When your rating is below 4.0
+- Without any recent updates
+
+### Pitch Template
+
+```
+Subject: [App Name] — [One-line hook]
+
+Hi App Store Editorial Team,
+
+[App Name] is [one-sentence description].
+
+What makes us special:
+- [Unique value proposition]
+- [Apple technology adoption]
+- [User impact / social proof]
+
+We're launching [update/feature] on [date], which includes:
+- [Feature 1 — tied to Apple technology]
+- [Feature 2 — user benefit]
+- [Feature 3 — timely relevance]
+
+Our story: [2-3 sentences about why you built this]
+
+Stats: [rating] stars, [N] ratings, [growth metric]
+
+We'd love to be considered for featuring. Happy to provide
+any additional assets or information.
+
+[Your name]
+[Developer name]
+[App Store link]
+```
+
+## In-App Events Strategy
+
+In-App Events appear on the Today tab, search results, and your product page — they're a form of self-serve featuring.
+
+### Event Types
+
+| Type | Best For | Example |
+|------|----------|---------|
+| **Challenge** | Fitness, games, education | "30-Day Meditation Challenge" |
+| **Competition** | Games, social | "Weekly Leaderboard Tournament" |
+| **Live Event** | Streaming, sports, news | "Live Q&A with [Expert]" |
+| **Major Update** | Any app | "Introducing AI-Powered [Feature]" |
+| **New Season** | Games, content | "Summer Collection Now Available" |
+| **Premiere** | Content, media | "New Series: [Title]" |
+| **Special Event** | Any app | "Earth Day: Plant a Tree Challenge" |
+
+### Event Best Practices
+
+- Use all available character limits for event metadata
+- Create eye-catching event card artwork (1920×1080)
+- Schedule events 2+ weeks in advance
+- Run events regularly (Apple favors active developers)
+- Tie events to cultural moments and seasons
+
+## Output Format
+
+### Featuring Readiness Score
+
+```
+Overall Readiness: [X]/100
+
+Design Quality:     [X]/10  ████████░░
+Apple Tech:         [X]/10  ██████░░░░
+Quality Signals:    [X]/10  ████████░░
+Content & Story:    [X]/10  ██████████
+Rating:             [X]/10  ████████░░
+```
+
+### Action Plan
+
+**Before pitching (fix these first):**
+1. [critical gap to address]
+2. [critical gap to address]
+
+**Pitch strategy:**
+- Recommended timing: [when]
+- Story angle: [what angle to lead with]
+- Apple tech to highlight: [which technologies]
+
+**Ongoing featuring strategy:**
+- In-App Events calendar (next 3 months)
+- Technology adoption roadmap
+- Update cadence plan
+
+## Related Skills
+
+- `aso-audit` — Ensure listing quality before pitching
+- `screenshot-optimization` — Screenshots matter for editorial review
+- `app-launch` — Feature timing around launches
+- `review-management` — Rating must be 4.5+ before pitching

package/skills/apple-search-ads/SKILL.md

@@ -0,0 +1,205 @@
+---
+name: apple-search-ads
+description: When the user wants to set up, optimize, or scale Apple Search Ads (ASA) campaigns — including keyword bidding, match types, campaign structure, Creative Product Sets, CPP routing, and ROAS optimization. Use when the user mentions "Apple Search Ads", "ASA", "Search Ads", "Search tab ads", "Today tab ads", "CPT", "TTR", "Search Match", "exact match", "broad match", "CPP in ads", "ASA bidding", or "Search Ads budget". For Meta/Google UAC/TikTok paid UA, see ua-campaign.
+metadata:
+  version: 1.0.0
+---
+
+# Apple Search Ads
+
+You are a specialist in Apple Search Ads (ASA) — the only ad platform that places ads natively within the App Store. ASA drives highly qualified installs because users are already in purchase intent.
+
+## Why ASA Is Different
+
+- Users are actively searching the App Store — highest intent of any channel
+- Ads appear exactly like organic results (only "Ad" badge distinguishes them)
+- No audience targeting (demographics, interests) — only keyword-based
+- Conversion data is reliable (no ATT/SKAdNetwork limitations)
+- CPI is typically higher than other channels but LTV is proportionally higher
+
+## Campaign Types
+
+| Placement | Where it appears | Best for |
+|-----------|-----------------|---------|
+| **Search Results** | Below the first organic result for a keyword | Keyword-specific intent capture |
+| **Search Tab** | Top of the Search tab before user types | Brand awareness, broad reach |
+| **Today Tab** | App Store home page | High-visibility brand moments |
+| **Product Pages** | Competitor and related app pages | Competitive conquesting |
+
+**Start with Search Results.** It's the highest-intent, most measurable, most controllable placement.
+
+## Account Structure
+
+```
+Account
+└── App (one per app)
+    ├── Campaign: Brand
+    │   └── Ad Group: Brand keywords
+    ├── Campaign: Competitor
+    │   └── Ad Group: Competitor app names
+    ├── Campaign: Category
+    │   └── Ad Group: Generic category terms
+    ├── Campaign: Discovery (Search Match)
+    │   └── Ad Group: Search Match on (no keywords)
+    └── Campaign: Search Tab (optional)
+        └── Ad Group: (no keywords needed)
+```
+
+### Why Separate Campaigns
+
+- Separate budgets (protect brand spend from being eaten by generic)
+- Separate bid strategies per intent type
+- Clean performance data per keyword type
+- Easier to pause/scale individual segments
+
+## Match Types
+
+| Match Type | How it works | Use for |
+|------------|-------------|---------|
+| **Exact** | Only triggers on exact keyword | High-value, proven terms |
+| **Broad** | Triggers on variations, related terms | Discovery |
+| **Search Match** | Apple auto-matches your app to relevant searches | Discovery campaign only |
+
+**Workflow:** Use Search Match + broad in discovery. Mine the search terms report weekly. Move top performers to exact match in a separate campaign with higher bids.
+
+## Keyword Strategy
+
+### Seed List by Campaign
+
+**Brand campaign:**
+- Your app name (exact)
+- Common misspellings
+- Your developer name
+
+**Competitor campaign:**
+- Top 5–10 competitor app names (exact)
+- Tip: bid lower, watch conversion — brand-searchers for competitors convert at lower rates
+
+**Category campaign:**
+- High-volume generic terms: "meditation app", "habit tracker", "budget planner"
+- Long-tail terms: "meditation app for anxiety", "daily habit tracker free"
+
+Use Appeeky to validate volume and difficulty:
+```bash
+GET /v1/keywords/metrics?keywords=meditation+app,mindfulness,sleep+sounds&country=us
+GET /v1/keywords/suggestions?term=meditation&country=us
+```
+
+### Negative Keywords
+
+Essential to prevent waste. Add negatives at account level:
+- Competitor names you're not targeting (avoid accidentally winning at bad CVR)
+- Irrelevant terms from Search Match (review weekly)
+- Terms with high impressions, zero taps
+
+## Bidding Strategy
+
+### Starting Bids
+
+| Campaign | Starting bid strategy |
+|---------|--------------------|
+| Brand | High (you should always win your brand terms) — start at $2–5 |
+| Competitor | Moderate — start at $1–2, watch CVR |
+| Category | Moderate — start at $0.80–1.50 |
+| Discovery | Low — start at $0.50–0.80 |
+
+### Bid Optimization Signals
+
+| Signal | Action |
+|--------|--------|
+| Low impression share (<50%) | Increase bid |
+| High TTR but low conversion | Improve product page or paywall |
+| Low TTR | Creative may not match keyword intent |
+| High CVR but spend not scaling | Increase bid or budget cap |
+| CPT rising with no CVR improvement | Reduce bid or pause keyword |
+
+**Target CPT** = Target CPI × Historical CVR (installs/taps)
+
+### Automated Bidding
+
+ASA offers automated bidding toward a target CPA or target ROAS. Use only after:
+- Campaign has 50+ conversions per ad group per week (minimum data)
+- Manual bidding has established a baseline CPT
+
+## Creative Product Sets (CPS) and CPP Routing
+
+Link **Custom Product Pages** (CPPs) to specific ad groups to show tailored creatives:
+
+```
+Ad Group: "yoga app" keyword → CPP: Yoga-themed screenshots
+Ad Group: "sleep sounds" keyword → CPP: Sleep-themed screenshots
+Ad Group: Competitor keywords → CPP: Comparison-focused screenshots
+```
+
+**Why this works:** Users searching "yoga app" see yoga screenshots instead of generic app screenshots. TTR and CVR both improve (typically +15–30%).
+
+Setup: App Store Connect → Custom Product Pages → create pages → ASA → Ad Group → select CPP.
+
+## Metrics and Benchmarks
+
+| Metric | Formula | Benchmark |
+|--------|---------|-----------|
+| **TTR** | Taps / Impressions | > 5% strong; < 3% investigate creative |
+| **CVR** | Installs / Taps | > 50% good; < 30% review product page |
+| **CPT** | Spend / Taps | Varies by category |
+| **CPI** | Spend / Installs | Varies; compare to LTV |
+| **ROAS** | Revenue / Spend | > 100% = profitable; target 150%+ |
+
+## Weekly Optimization Checklist
+
+```
+- [ ] Review Search Terms report → add top new terms to exact match campaigns
+- [ ] Add new negatives from irrelevant search terms
+- [ ] Check impression share per keyword → adjust bids where < 50%
+- [ ] Pause keywords with 100+ taps and 0 installs
+- [ ] Review TTR per ad group → test new CPS/CPP if TTR < 3%
+- [ ] Check budget pacing — no campaigns hitting daily cap before noon
+- [ ] Compare CVR across campaigns — Category vs Brand vs Competitor
+```
+
+## Scaling Checklist
+
+Before increasing budget:
+```
+- [ ] CVR > 30% on main campaigns
+- [ ] CPI < 3× your target
+- [ ] Bid strategy is manual and stable
+- [ ] Negative keyword list maintained
+- [ ] At least 2 CPP variants tested
+```
+
+## Output Format
+
+### Campaign Audit
+
+```
+Account: [App Name]
+
+Campaign Structure:
+  ✓/✗ Brand campaign
+  ✓/✗ Competitor campaign
+  ✓/✗ Category campaign
+  ✓/✗ Discovery campaign
+
+Performance ([period]):
+  Impressions: [N]
+  Taps:        [N] (TTR: [X]%)
+  Installs:    [N] (CVR: [X]%)
+  CPI:         $[N]
+  Spend:       $[N]
+
+Top issues:
+1. [issue] — [recommended fix]
+2. [issue] — [recommended fix]
+
+Priority actions:
+1. [specific change] — Expected impact: [rationale]
+2. [specific change] — Expected impact: [rationale]
+```
+
+## Related Skills
+
+- `ua-campaign` — Full paid UA across all channels (Meta, Google, TikTok)
+- `keyword-research` — Identify keywords to target in ASA
+- `screenshot-optimization` — Build CPPs for keyword-specific creatives
+- `ab-test-store-listing` — Test product page CVR before scaling spend

package/skills/asc-metrics/SKILL.md

@@ -0,0 +1,157 @@
+---
+name: asc-metrics
+description: When the user wants to analyze their own app's actual performance data from App Store Connect — real downloads, revenue, IAP, subscriptions, trials, or country breakdowns synced via Appeeky Connect. Use when the user asks about "my downloads", "my revenue", "how is my app performing", "ASC data", "sales and trends", "my subscription numbers", "App Store Connect metrics", or wants to compare periods or top markets. For third-party app estimates, see app-analytics. For subscription analytics depth, see monetization-strategy.
+metadata:
+  version: 1.0.0
+---
+
+# ASC Metrics
+
+You analyze the user's **official App Store Connect data** synced into Appeeky — exact downloads, revenue, IAP, subscriptions, and trials. This is first-party data, not estimates.
+
+## Prerequisites
+
+- Appeeky account with ASC connected (Settings → Integrations → App Store Connect)
+- Indie plan or higher (2 credits per request)
+- Data syncs nightly; up to 90 days of history available
+
+If ASC is not connected, prompt the user to connect it at [appeeky.com/settings](https://appeeky.com) and return.
+
+## Initial Assessment
+
+1. Check for `app-marketing-context.md` — read it for app context
+2. Ask: **What do you want to analyze?** (downloads, revenue, subscriptions, country breakdown, trend comparison)
+3. Ask: **Which time period?** (default: last 30 days)
+4. Ask: **Specific app or all apps?**
+
+## Fetching Data
+
+### Step 1 — List available apps
+
+```bash
+GET /v1/connect/metrics/apps
+```
+
+Match the user's app to an `app_apple_id` if not already known.
+
+### Step 2 — Get overview (portfolio)
+
+```bash
+GET /v1/connect/metrics?from=YYYY-MM-DD&to=YYYY-MM-DD
+```
+
+### Step 3 — Get app detail (single app)
+
+```bash
+GET /v1/connect/metrics/apps/:appId?from=YYYY-MM-DD&to=YYYY-MM-DD
+```
+
+Response includes: `daily[]`, `countries[]`, `totals`.
+
+See full API reference: [appeeky-connect.md](../../tools/integrations/appeeky-connect.md)
+
+## Analysis Frameworks
+
+### Period-over-Period Comparison
+
+Fetch two equal-length windows and compare:
+
+| Metric | Prior Period | Current Period | Change |
+|--------|-------------|----------------|--------|
+| Downloads | [N] | [N] | [+/-X%] |
+| Revenue | $[N] | $[N] | [+/-X%] |
+| Subscriptions | [N] | [N] | [+/-X%] |
+| Trials | [N] | [N] | [+/-X%] |
+| Trial → Sub Rate | [X]% | [X]% | [+/-X pp] |
+
+**What to look for:**
+- Downloads rising but revenue flat → pricing or paywall issue
+- Trials rising but conversions flat → paywall or onboarding issue
+- Revenue rising but downloads flat → good monetization improvement
+
+### Daily Trend Analysis
+
+From `daily[]`, identify:
+- **Spikes** — Did a feature, update, or press trigger them?
+- **Drops** — Correlate with app updates, seasonality, or algorithm changes
+- **Trend direction** — 7-day moving average vs prior 7 days
+
+### Country Breakdown
+
+Sort `countries[]` by downloads and revenue:
+1. **Top 5 by downloads** — Are you investing in ASO for these markets?
+2. **Top 5 by revenue** — Higher ARPD (avg revenue per download) = prioritize ASO
+3. **High downloads, low revenue** — Markets with weak monetization
+4. **Low downloads, high revenue** — Under-tapped premium markets (localize)
+
+### Revenue Quality Check
+
+Compute from the data:
+
+| Metric | Formula | Benchmark |
+|--------|---------|-----------|
+| ARPD | Revenue / Downloads | > $0.05 good; > $0.20 excellent |
+| Trial rate | Trials / Downloads | > 20% means strong paywall reach |
+| Sub conversion | Subscriptions / Trials | > 25% is strong |
+| Revenue per sub | Revenue / Subscriptions | Depends on pricing |
+
+## Output Format
+
+### Performance Snapshot
+
+```
+📊 [App Name] — [Period]
+
+Downloads:     [N]  ([+/-X%] vs prior period)
+Revenue:       $[N] ([+/-X%])
+Subscriptions: [N]  ([+/-X%])
+Trials:        [N]  ([+/-X%])
+IAP Count:     [N]  ([+/-X%])
+Trial→Sub:     [X]%
+
+Top Markets (downloads):
+  1. [Country] — [N] downloads, $[N]
+  2. [Country] — [N] downloads, $[N]
+  3. [Country] — [N] downloads, $[N]
+
+Key Observations:
+- [What the trend means]
+- [Any anomaly and likely cause]
+- [Opportunity identified]
+
+Recommended Actions:
+1. [Specific action based on data]
+2. [Specific action based on data]
+```
+
+### Trend Alert
+
+When a significant change (>20%) is detected, flag it:
+
+```
+⚠️  Downloads dropped [X]% this week
+    Possible causes: [list 2-3 hypotheses]
+    Next steps: [specific diagnostic actions]
+```
+
+## Common Questions
+
+**"Why did my downloads drop?"**
+1. Pull daily trend — when did it start?
+2. Check if an update shipped on that date
+3. Check keyword rankings (use `keyword-research` skill)
+4. Check competitor activity (use `competitor-analysis` skill)
+
+**"Which countries should I localize for?"**
+Pull country breakdown → sort by downloads → flag high-download, non-English markets → use `localization` skill
+
+**"Is my monetization improving?"**
+Compare trial rate and trial→sub rate period over period → use `monetization-strategy` skill for paywall improvements
+
+## Related Skills
+
+- `app-analytics` — Full analytics stack setup and KPI framework
+- `monetization-strategy` — Improve subscription conversion and paywall
+- `retention-optimization` — Reduce churn using the metrics as input
+- `localization` — Expand top-performing markets seen in country data
+- `ua-campaign` — Validate whether paid installs show in downloads spike