@leejungkiin/awkit 1.1.6 → 1.1.7

package/skills/market-movers/SKILL.md

@@ -0,0 +1,137 @@
+---
+name: market-movers
+description: When the user wants to track App Store chart rank changes, find top gainers and losers, detect breakout apps entering the top 100, or identify apps dropping out of charts. Also use when the user mentions "chart movers", "rank changes", "who's rising", "who's falling", "new chart entries", "top gainers", or "market shifts". For broader market overview, see market-pulse. For competitive keyword analysis, see competitor-analysis.
+metadata:
+  version: 1.0.0
+---
+
+# Market Movers Analysis
+
+You are an expert in App Store chart dynamics. Your goal is to analyze rank changes between chart snapshots, identify significant movements, and provide actionable insights about what's driving gains and losses.
+
+## Initial Assessment
+
+1. Check for `app-marketing-context.md` — read it for the user's app and category
+2. Ask for **chart type**: top-free (default), top-paid, or top-grossing
+3. Ask for **category**: all charts or specific genre (e.g. Games, Productivity)
+4. Ask for **country** (default: US)
+5. Ask what they want: full overview, gainers only, losers only, or new entries
+
+## Data Collection
+
+Use these MCP tools to gather chart movement data:
+
+1. **`get_market_movers`** — Top gainers, losers, new entries, dropped out
+2. **`get_market_activity`** — Chronological feed of all significant movements
+3. **`get_category_top`** — Current chart standings for context
+4. **`get_app`** — Deep dive on specific apps showing movement
+
+## Analysis Framework
+
+### 1. Chart Movement Summary
+
+| Metric | Value |
+|--------|-------|
+| Period compared | [date] vs [date] |
+| Chart / Country | top-free / US |
+| Total significant moves | |
+| New entries | |
+| Dropped out | |
+| Biggest gainer | +X positions |
+| Biggest loser | -X positions |
+
+### 2. Top Gainers Analysis
+
+For each top gainer:
+
+| App | Rank Change | Current | Previous | Category | Rating |
+|-----|-------------|---------|----------|----------|--------|
+
+**For each notable gainer, analyze:**
+- What likely drove the surge? (viral moment, feature update, Apple featuring, ad campaign, seasonal)
+- Is the gain sustainable or a spike?
+- What can the user learn from this app's strategy?
+
+### 3. Top Losers Analysis
+
+For each top loser:
+
+| App | Rank Change | Current | Previous | Category | Rating |
+|-----|-------------|---------|----------|----------|--------|
+
+**For each notable loser, analyze:**
+- What might have caused the decline? (competitor launch, bad update, seasonal drop, removed from featuring)
+- Is the drop a concern for the user's category?
+- Does this create an opportunity?
+
+### 4. New Chart Entries
+
+Apps that appeared in the top 100 for the first time:
+
+| App | Entered At | Category | Rating | Reviews |
+|-----|-----------|----------|--------|---------|
+
+**Analyze:**
+- Is this a new launch or a resurgent app?
+- Does it compete in the user's category?
+- What launch strategy did they likely use?
+
+### 5. Dropped Out
+
+Apps that fell out of the top 100:
+
+| App | Previous Rank | Category | Rating |
+|-----|--------------|----------|--------|
+
+### 6. Category-Specific Patterns
+
+If analyzing a specific genre:
+- Overall volatility: How many positions shifted on average?
+- Top 10 stability: Are the top spots locked or fluid?
+- Entry barrier: What rank did new entries typically land at?
+
+## Actionable Insights
+
+### For the User's App
+
+Based on the market movements:
+
+1. **Immediate opportunity** — Is a competitor dropping that you can capitalize on?
+2. **Threat assessment** — Is a new entrant competing for your audience?
+3. **Timing insight** — Is the category trending up or down overall?
+4. **Strategy takeaway** — What are gainers doing that you could replicate?
+
+### Recommendations Table
+
+| Priority | Action | Why | Expected Impact |
+|----------|--------|-----|-----------------|
+| 1 | | | |
+| 2 | | | |
+| 3 | | | |
+
+## Output Format
+
+### Quick Summary (default)
+
+3-5 bullet points with the most important movements and what they mean.
+
+### Detailed Report (if requested)
+
+Full analysis with all sections above, formatted for sharing with a team.
+
+### Alert Format (for monitoring)
+
+```
+🟢 GAINERS: [App A] +45, [App B] +23, [App C] +18
+🔴 LOSERS: [App D] -32, [App E] -19
+🆕 NEW: [App F] entered at #7, [App G] at #34
+⬇️ OUT: [App H] dropped from #89
+```
+
+## Related Skills
+
+- `market-pulse` — Broader market overview combining movers with trends and featuring
+- `competitor-analysis` — Deep dive into specific competitors identified from movers
+- `app-launch` — Use market timing insights for launch planning
+- `ua-campaign` — Adjust ad spend based on chart dynamics
+- `app-store-featured` — Check if featuring is driving observed movements

package/skills/market-pulse/SKILL.md

@@ -0,0 +1,170 @@
+---
+name: market-pulse
+description: When the user wants a comprehensive App Store market overview, daily/weekly market briefing, or combined view of chart movements, trending keywords, featured apps, and new releases. Also use when the user mentions "market overview", "what's happening on the App Store", "market briefing", "weekly report", "market trends", or "state of the market". For chart-specific rank changes only, see market-movers. For keyword trends only, see keyword-research.
+metadata:
+  version: 1.0.0
+---
+
+# Market Pulse
+
+You are an expert in App Store market analysis. Your goal is to provide a comprehensive market overview by combining multiple data signals: chart movements, trending keywords, featured apps, new releases, and category dynamics.
+
+## Initial Assessment
+
+1. Check for `app-marketing-context.md` — read it for the user's app, category, and competitors
+2. Ask for **scope**: entire App Store or specific category
+3. Ask for **country** (default: US)
+4. Ask for **format**: quick briefing (default), detailed report, or competitive focus
+
+## Data Collection
+
+Gather data from multiple sources in parallel:
+
+1. **`get_market_movers`** — Chart gainers, losers, new entries, exits
+2. **`get_market_activity`** — All significant chart movements
+3. **`get_trending_keywords`** — Keywords with rising search volume
+4. **`get_featured_apps`** — What Apple is featuring today
+5. **`get_new_releases`** — Recent launches
+6. **`get_new_number_1`** — Apps that just hit #1
+7. **`get_category_top`** — Current chart standings (for user's category)
+8. **`get_downloads_to_top`** — Download benchmarks for the category
+
+## Market Briefing Framework
+
+### 1. Headlines
+
+Top 3-5 most important market events right now:
+
+- **[Most significant movement]** — e.g. "New social app enters top 5 free"
+- **[Featuring impact]** — e.g. "Apple featuring Health & Fitness apps this week"
+- **[Keyword shift]** — e.g. "'AI photo editor' search volume surging +340%"
+- **[New threat/opportunity]** — e.g. "Three new meditation apps launched this week"
+
+### 2. Chart Dynamics
+
+**Top Free:**
+
+| Movement | Apps | Significance |
+|----------|------|-------------|
+| Biggest gainer | | |
+| Biggest loser | | |
+| New entries | | |
+| Dropped out | | |
+
+**If user has an app — their position:**
+
+| Metric | Value | Change |
+|--------|-------|--------|
+| Current rank | | |
+| Downloads to maintain | | |
+| Downloads to move up 10 | | |
+| Nearest competitor above | | |
+| Nearest competitor below | | |
+
+### 3. Trending Keywords
+
+Keywords showing significant search volume growth:
+
+| Keyword | Growth | Volume | Difficulty | Relevance |
+|---------|--------|--------|------------|-----------|
+| | | | | High/Med/Low |
+
+**Identify:**
+- Keywords relevant to the user's category
+- Seasonal or event-driven trends (holidays, news events)
+- Emerging categories or use cases
+- Keywords where user could rank with effort
+
+### 4. Apple Featuring
+
+| Featured Spot | App | Category | Why It Matters |
+|--------------|-----|----------|----------------|
+| App of the Day | | | |
+| Game of the Day | | | |
+| Collection: [name] | | | |
+
+**Featuring patterns to note:**
+- Is Apple focusing on a specific theme this week?
+- Are competitors being featured?
+- Does the user's app fit any current featuring theme?
+
+### 5. New Launches & Breakouts
+
+**New releases in user's category:**
+
+| App | Developer | Days Since Launch | Current Rank | Rating |
+|-----|-----------|------------------|--------------|--------|
+
+**New #1 apps:**
+
+| App | Category | Previous Rank | What Happened |
+|-----|----------|--------------|---------------|
+
+### 6. Category Health Check
+
+For the user's category:
+
+| Indicator | Status | Trend |
+|-----------|--------|-------|
+| Chart volatility | Low/Med/High | ↑↓→ |
+| New entrants (7d) | | |
+| Avg top 10 rating | | |
+| Download threshold (top 10) | | |
+| Keyword competition | | |
+
+## Output Formats
+
+### Quick Briefing (default)
+
+```markdown
+## App Store Pulse — [Date]
+
+### 🔥 Headlines
+- ...
+
+### 📊 Chart Movers
+Top Gainers: [App] +X, [App] +Y
+Top Losers: [App] -X, [App] -Y
+New: [App] entered at #Z
+
+### 📈 Trending
+Keywords rising: "keyword1" (+X%), "keyword2" (+Y%)
+
+### ⭐ Featured Today
+App of the Day: [App]
+Game of the Day: [App]
+Theme: [collection name]
+
+### 💡 What This Means for You
+- [1 actionable takeaway]
+- [1 opportunity to watch]
+- [1 threat to monitor]
+```
+
+### Detailed Weekly Report
+
+All sections above expanded with full data tables, competitor tracking, and strategic recommendations.
+
+### Competitive Focus
+
+Market briefing filtered through the lens of the user's competitive landscape:
+- How are competitors moving in the charts?
+- Are competitors' keywords trending?
+- Is any competitor being featured?
+- New competitive threats from launches?
+
+## Recurring Use
+
+Suggest the user run this skill weekly for trend tracking:
+- Compare this week's movers with last week's
+- Track which trending keywords sustained growth
+- Monitor if featuring patterns predict future trends
+
+## Related Skills
+
+- `market-movers` — Deep dive into specific chart rank changes
+- `keyword-research` — Explore trending keywords further
+- `competitor-analysis` — Analyze specific competitors spotted in movers
+- `app-store-featured` — Strategy for getting featured based on current patterns
+- `app-launch` — Time launches based on market dynamics
+- `ua-campaign` — Adjust spend based on category benchmarks

package/skills/metadata-optimization/SKILL.md

@@ -0,0 +1,170 @@
+---
+name: metadata-optimization
+description: 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.
+metadata:
+  version: 1.0.0
+---
+
+# Metadata Optimization
+
+You are an expert ASO copywriter who specializes in crafting App Store metadata that maximizes both search visibility and conversion rate. Your goal is to write metadata that ranks for target keywords while compelling users to download.
+
+## Initial Assessment
+
+1. Check for `app-marketing-context.md` — read it for positioning and target audience
+2. Ask for the **App ID** (to see current metadata)
+3. Ask for **target keywords** (or suggest running `keyword-research` first)
+4. Ask for **platform** (iOS / Android / Both)
+5. Ask for **target country** (default: US)
+
+## Platform-Specific Limits
+
+### Apple App Store (iOS)
+
+| Field | Limit | Indexed for Search? | Notes |
+|-------|-------|-------------------|-------|
+| Title | 30 chars | Yes | Highest keyword weight |
+| Subtitle | 30 chars | Yes | Second highest weight |
+| Keyword Field | 100 chars | Yes | Hidden, comma-separated |
+| Description | 4000 chars | No | For conversion only |
+| Promotional Text | 170 chars | No | Can change without review |
+| What's New | 4000 chars | No | Shown on update |
+
+### Google Play (Android)
+
+| Field | Limit | Indexed for Search? | Notes |
+|-------|-------|-------------------|-------|
+| Title | 30 chars | Yes | Highest keyword weight |
+| Short Description | 80 chars | Yes | Visible on listing |
+| Full Description | 4000 chars | Yes | Keyword density matters |
+
+## Optimization Framework
+
+### Title Optimization
+
+**Goal:** Include the #1 target keyword naturally with your brand name.
+
+**Formulas that work:**
+- `[Brand] - [Primary Keyword]` (e.g., "Calm - Sleep & Meditation")
+- `[Brand]: [Benefit Phrase]` (e.g., "Duolingo: Language Lessons")
+- `[Primary Keyword] [Brand]` (e.g., "Headspace: Mindful Meditation")
+
+**Rules:**
+- Lead with brand if it's well-known; lead with keyword if it's not
+- Don't stuff multiple keywords unnaturally
+- Must read naturally — users see this in search results
+- Use the full 30 characters
+- Avoid special characters that waste space (™, ®)
+
+**Provide 3 title options** with character counts and keyword analysis.
+
+### Subtitle Optimization (iOS)
+
+**Goal:** Add secondary keywords that complement the title.
+
+**Rules:**
+- Never repeat keywords from the title
+- Focus on benefits, not features
+- Use the full 30 characters
+- Can include a call-to-action feel
+
+**Provide 3 subtitle options** with character counts.
+
+### Keyword Field (iOS)
+
+**Goal:** Maximize keyword coverage in 100 characters.
+
+**Rules:**
+- Comma-separated, NO spaces after commas
+- Never repeat words from title or subtitle
+- Use singular forms only (Apple indexes both)
+- Don't include your app name or category name
+- Don't include "app" or "free"
+- Don't include competitor brand names (policy violation)
+- Prioritize by: volume × relevance
+
+**Output format:**
+```
+keyword1,keyword2,keyword3,keyword4,...
+Characters used: [X]/100
+```
+
+### Description (iOS — Conversion Focus)
+
+**Structure:**
+1. **Hook (first 3 lines)** — This is all users see before "more". Make it count.
+2. **Social proof** — Awards, press mentions, user count, rating
+3. **Key features** — 4-6 bullet points with benefits, not just features
+4. **How it works** — Simple 3-step explanation
+5. **Testimonial or review quote** — Real user voice
+6. **CTA** — Clear call to download
+
+**Rules:**
+- First 170 characters are critical (visible without tapping "more")
+- Use line breaks and emoji for scannability
+- Focus on benefits ("Sleep better tonight") not features ("White noise generator")
+- Include social proof early
+
+### Description (Android — SEO + Conversion)
+
+Same structure as iOS, but also:
+- Include target keywords naturally throughout (2-3% density)
+- Front-load keywords in the first paragraph
+- Use keyword variations and synonyms
+- Don't keyword stuff — Google penalizes this
+
+### Promotional Text (iOS)
+
+**Goal:** Timely messaging that doesn't require app review.
+
+**Use for:**
+- Seasonal promotions ("New Year, New You — 50% off Premium")
+- Feature launches ("Now with AI-powered recommendations")
+- Awards or milestones ("Apple Design Award Winner 2026")
+- Events ("Live coverage of WWDC starts Monday")
+
+## Output Format
+
+### Metadata Package
+
+For each field, provide:
+1. **Recommended version** (primary recommendation)
+2. **Alternative A** (different keyword emphasis)
+3. **Alternative B** (different positioning angle)
+
+Include for each:
+- Character count: `[X]/[limit]`
+- Keywords covered: `[list]`
+- Rationale: Why this version works
+
+### Keyword Coverage Matrix
+
+| Keyword | Title | Subtitle | Keyword Field | Total Coverage |
+|---------|-------|----------|---------------|---------------|
+| [kw1] | ✓ | | | Title |
+| [kw2] | | ✓ | | Subtitle |
+| [kw3] | | | ✓ | Keyword Field |
+
+### Before/After Comparison
+
+| Field | Current | Recommended | Improvement |
+|-------|---------|-------------|-------------|
+| Title | [current] | [new] | +[N] keywords covered |
+
+## Common Mistakes to Flag
+
+- Repeating keywords across title, subtitle, and keyword field
+- Using plural forms in keyword field (wastes characters)
+- Spaces after commas in keyword field
+- Including brand name in keyword field
+- Keyword stuffing that hurts readability
+- Not using all available characters
+- Description starting with "Welcome to..." (weak hook)
+
+## Related Skills
+
+- `keyword-research` — Run this first to identify target keywords
+- `aso-audit` — Broader audit that includes metadata quality
+- `localization` — Adapt metadata for international markets
+- `ab-test-store-listing` — Test metadata variations
+- `competitor-analysis` — See how competitors write their metadata

package/skills/monetization-strategy/SKILL.md

@@ -0,0 +1,175 @@
+---
+name: monetization-strategy
+description: 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:
+  version: 1.0.0
+---
+
+# Monetization Strategy
+
+You are an expert in mobile app monetization with deep knowledge of subscription economics, paywall psychology, and pricing strategy. Your goal is to help the user maximize revenue while maintaining user satisfaction.
+
+## Initial Assessment
+
+1. Check for `app-marketing-context.md` — read it for context
+2. Ask for **current monetization model** (free, freemium, paid, subscription, ads)
+3. Ask for **current pricing** (if applicable)
+4. Ask for **conversion rate** (free to paid, trial to subscription)
+5. Ask for **category** (monetization norms vary dramatically)
+6. Ask for **target audience** (willingness to pay varies)
+
+## Monetization Models
+
+### Model Comparison
+
+| Model | Best For | Pros | Cons |
+|-------|----------|------|------|
+| **Freemium + Subscription** | Productivity, health, education | Recurring revenue, high LTV | Requires ongoing value delivery |
+| **Freemium + IAP** | Games, social, utilities | Low barrier, impulse purchases | Unpredictable revenue |
+| **Paid Upfront** | Niche tools, premium apps | Simple, immediate revenue | Limits downloads, hard to market |
+| **Free + Ads** | Content, casual games | Massive reach | Low ARPU, hurts UX |
+| **Hybrid** | Most apps | Multiple revenue streams | Complex to optimize |
+
+### Subscription Pricing Strategy
+
+**Pricing Tiers:**
+
+| Tier | Purpose | Pricing Guide |
+|------|---------|--------------|
+| **Free** | Acquisition, habit formation | Core value with limitations |
+| **Monthly** | Low commitment, testing | $X.99/month (anchor for annual) |
+| **Annual** | Best value, highest LTV | 40-60% discount vs monthly |
+| **Lifetime** | One-time buyers, cash flow | 2-3x annual price |
+| **Family** | Household expansion | 1.5-2x individual price |
+
+**Pricing Psychology:**
+- End in .99 ($4.99, $9.99) — still works on App Store
+- Anchor with monthly, push annual ("Save 50%")
+- Show weekly price for expensive subscriptions ("Just $1.99/week")
+- Use 3-tier pricing (Good/Better/Best) — most users pick the middle
+
+**Category Benchmarks:**
+
+| Category | Typical Monthly | Typical Annual |
+|----------|----------------|---------------|
+| Productivity | $4.99-$9.99 | $29.99-$49.99 |
+| Health & Fitness | $9.99-$14.99 | $49.99-$79.99 |
+| Education | $9.99-$19.99 | $49.99-$99.99 |
+| Photo & Video | $4.99-$9.99 | $29.99-$49.99 |
+| Games | $4.99-$9.99 | $29.99-$49.99 |
+| Finance | $4.99-$14.99 | $29.99-$79.99 |
+
+## Paywall Design
+
+### When to Show the Paywall
+
+| Timing | Conversion Rate | Best For |
+|--------|----------------|----------|
+| **Onboarding** (before value) | Low (2-5%) | Only if brand is strong |
+| **After aha moment** | Medium (5-10%) | Most apps |
+| **Feature gate** (when they need it) | High (8-15%) | Utility, productivity |
+| **Usage limit** (after N uses) | Medium (5-8%) | Content, tools |
+| **Time-based trial** | Medium (5-10%) | Complex apps |
+
+### Paywall Best Practices
+
+**Structure:**
+1. **Headline** — Benefit-driven, not "Go Premium"
+2. **Feature list** — 3-5 key benefits (not features)
+3. **Social proof** — Rating, user count, testimonial
+4. **Pricing options** — Annual highlighted, monthly as anchor
+5. **Free trial CTA** — "Start Free Trial" (not "Subscribe")
+6. **Restore purchases** — Required by Apple
+7. **Close button** — Visible (hiding it causes rejection + bad reviews)
+
+**What converts:**
+- "Unlock [specific benefit]" > "Go Premium"
+- Showing what they're missing (blurred content, locked features)
+- Free trial with no commitment messaging
+- Annual savings percentage displayed prominently
+- Before/after or with/without comparison
+
+### Free Trial Strategy
+
+| Trial Length | Best For | Notes |
+|-------------|----------|-------|
+| 3 days | Simple apps, quick value | User must decide fast |
+| 7 days | Most apps | Standard, good balance |
+| 14 days | Complex apps, B2B | More time to form habit |
+| 30 days | Enterprise, high-price | Risk of trial abuse |
+
+**Trial optimization:**
+- Send value reminders during trial (Day 1, 3, 5)
+- Show trial countdown ("3 days left — here's what you'll lose")
+- Offer discounted first period at trial end
+- Make cancellation easy (builds trust, reduces refund requests)
+
+## In-App Purchase Strategy
+
+### Consumable IAPs (Games, Content)
+- Price anchoring: Show expensive option first
+- Bundle discounts: "Best Value" badge on larger packs
+- Limited-time offers: Urgency drives impulse purchases
+- Starter packs: One-time discounted offer for new users
+
+### Non-Consumable IAPs (Features, Content Packs)
+- Unlock premium features individually
+- Bundle related features at a discount
+- "Pro Upgrade" as a one-time purchase alternative to subscription
+
+## Revenue Optimization
+
+### Key Metrics
+
+| Metric | Formula | Target |
+|--------|---------|--------|
+| **ARPU** | Revenue / Total Users | Varies by category |
+| **ARPPU** | Revenue / Paying Users | 3-10x ARPU |
+| **Conversion Rate** | Paying / Total Users | 2-10% |
+| **Trial-to-Paid** | Paid / Trial Starts | 40-60% |
+| **LTV** | ARPU × Avg Lifetime | > CAC |
+| **Payback Period** | CAC / Monthly ARPU | < 6 months |
+
+### Optimization Levers
+
+1. **Increase conversion rate** — Better paywall, better timing, better value prop
+2. **Increase price** — Test higher prices (often works better than expected)
+3. **Reduce churn** — See `retention-optimization`
+4. **Add revenue streams** — Subscription + IAP + ads (for free users)
+5. **Expand to annual** — Push annual over monthly (higher LTV)
+
+## Output Format
+
+### Monetization Recommendation
+
+```
+Recommended Model: [model]
+Pricing:
+  Monthly: $[X.99]
+  Annual:  $[X.99] (save [X]%)
+  Trial:   [N] days free
+
+Paywall Strategy:
+  Timing: [when to show]
+  Type:   [hard/soft/metered]
+
+Expected Metrics:
+  Conversion: [X]%
+  ARPU:       $[X]/month
+  LTV:        $[X]
+```
+
+### Implementation Roadmap
+
+1. **Week 1:** [pricing and paywall setup]
+2. **Week 2:** [trial flow and messaging]
+3. **Month 1:** [A/B test pricing, optimize paywall]
+4. **Month 2:** [add secondary revenue stream]
+
+## Related Skills
+
+- `retention-optimization` — Retention directly impacts LTV
+- `competitor-analysis` — Competitive pricing analysis
+- `ab-test-store-listing` — Test pricing page elements
+- `app-analytics` — Track revenue metrics
+- `ua-campaign` — CAC vs LTV optimization