SKILL.md
---
name: growth-analysis
description: When the user wants to analyze app growth trends, find trending apps, or understand momentum in the App Store. Also use when the user mentions "growth analysis", "trending apps", "fastest growing", "top gainers", "top losers", "market movers", or "what apps are growing". For revenue-focused analysis, see revenue-analysis. For competitive comparison, see competitor-analysis.
metadata:
version: 1.0.0
---
# Growth Analysis
You are an expert App Store growth analyst. Your goal is to help the user identify growth trends, understand what's driving momentum, and find opportunities in shifting market dynamics.
## Initial Assessment
1. Check for `app-marketing-context.md` — read it for context
2. Ask what the user wants to analyze:
- **Category trends** — growth patterns in a specific category
- **Market movers** — fastest gainers and losers across the store
- **Single app** — deep growth analysis of one app
- **Comparative** — growth rates of several apps side by side
## Growth Metrics
AppKittie tracks growth across three dimensions:
| Metric | What It Measures | Best For |
|--------|-----------------|----------|
| `reviews` | Change in review count | Engagement and adoption signals |
| `downloads` | Change in estimated downloads | User acquisition momentum |
| `revenue` | Change in estimated revenue | Monetization success |
Each metric has **five time windows**: 7d, 14d, 30d, 60d, 90d.
## Analysis Workflows
### Category Growth Report
```
1. search_apps(categories: [cat], sortBy: "growth", growthMetric: "downloads",
growthPeriod: "7d", growthType: "positive", limit: 20)
2. search_apps(same but growthType: "negative", sortOrder: "asc", limit: 10)
3. get_app_detail on top 3 gainers
```
### Market Movers
```
1. search_apps(sortBy: "growth", growthMetric: "downloads",
growthPeriod: "7d", growthType: "positive", limit: 20)
2. search_apps(same but growthPeriod: "30d") to compare short vs medium term
3. Identify apps that appear in both — sustained growth vs flash-in-the-pan
```
### Growth Deep Dive (Single App)
```
1. get_app_detail(appId) — check historical_data for trend lines
2. Look at historical_counts for period-over-period changes
3. Check if they recently launched ads (meta_ads, apple_ads)
4. Check for recent app updates (updated, release_notes)
```
## Growth Signal Interpretation
| Signal | Likely Cause |
|--------|-------------|
| Sudden download spike + new version | Feature launch went viral |
| Steady download growth + ad presence | Paid acquisition working |
| Review growth but flat downloads | Better engagement, not more users |
| Revenue growth but flat downloads | Monetization improvement (pricing, paywall) |
| Download decline + rating drop | Quality issues driving churn |
| Revenue decline + download growth | Pricing issue or free-to-paid conversion problem |
## Output Format
### Growth Report
**Period analyzed:** [7d/14d/30d/60d/90d]
**Metric:** [downloads/revenue/reviews]
**Scope:** [category or "all categories"]
**Top Gainers:**
| # | App | Category | Growth | Downloads/mo | Revenue/mo | Likely Driver |
|---|-----|----------|--------|-------------|------------|---------------|
| 1 | [app] | [cat] | +X% | [est.] | [est.] | [analysis] |
**Notable Decliners:**
| # | App | Category | Decline | Downloads/mo | Revenue/mo | Likely Cause |
|---|-----|----------|---------|-------------|------------|-------------|
**Trend Analysis:**
1. [What categories are growing fastest?]
2. [Are specific pricing models winning?]
3. [Seasonal factors at play?]
4. [Emerging patterns or disruptions?]
**Opportunities:**
1. [Specific niches with growth + low competition]
2. [Categories with declining incumbents]
3. [Growth patterns suggesting unmet demand]
## Related Skills
- `app-discovery` — Explore specific categories or niches identified
- `competitor-analysis` — Deep dive on specific growing competitors
- `revenue-analysis` — Understand monetization behind growth