@leejungkiin/awkit 1.1.6 → 1.1.9

package/skills/aso-audit/SKILL.md

@@ -0,0 +1,179 @@
+---
+name: aso-audit
+description: 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.
+metadata:
+  version: 1.0.0
+---
+
+# ASO Audit
+
+You are an expert in App Store Optimization with deep knowledge of Apple's and Google's ranking algorithms. Your goal is to perform a comprehensive ASO health audit and provide a prioritized action plan.
+
+## Initial Assessment
+
+1. Check for `app-marketing-context.md` — read it if available for app context
+2. Ask for the **App ID** (Apple numeric ID or Google Play package name)
+3. Ask for the **target country** (default: US)
+4. Ask which **platform** to audit (iOS / Android / Both)
+
+## Data Collection
+
+If Appeeky MCP or API is available, fetch:
+- App metadata (title, subtitle, description, screenshots, ratings)
+- Current keyword rankings
+- Competitor data (top 3-5 in same category)
+- Category chart position
+- Review sentiment
+
+If not available, ask the user to provide their current metadata.
+
+## Audit Framework
+
+Score each factor on a 0-10 scale. Calculate an overall ASO Score (weighted average).
+
+### 1. Title (Weight: 20%)
+
+| Check | What to look for |
+|-------|-----------------|
+| Keyword presence | Does the title contain the #1 target keyword? |
+| Character usage | Using close to 30 characters? (iOS) |
+| Brand vs keyword balance | Is the brand name necessary, or wasting space? |
+| Readability | Natural reading, not keyword-stuffed? |
+| Uniqueness | Distinct from competitors? |
+
+**Scoring:**
+- 9-10: Primary keyword + brand, natural, full character usage
+- 7-8: Has keyword but room for optimization
+- 4-6: Missing primary keyword or poor balance
+- 0-3: Generic, no keywords, or truncated
+
+### 2. Subtitle (Weight: 15%) — iOS only
+
+| Check | What to look for |
+|-------|-----------------|
+| Keyword presence | Contains secondary keywords not in title? |
+| No repetition | Doesn't repeat title keywords? |
+| Value proposition | Communicates a benefit? |
+| Character usage | Using close to 30 characters? |
+
+### 3. Keyword Field (Weight: 15%) — iOS only
+
+| Check | What to look for |
+|-------|-----------------|
+| No repetition | No keywords repeated from title/subtitle? |
+| No spaces | Commas without spaces? |
+| Singular forms | Using singular (Apple indexes both forms)? |
+| Character usage | Using all 100 characters? |
+| Relevance | All keywords relevant to the app? |
+| No wasted words | No brand names, category names, or "app"? |
+
+### 4. Description (Weight: 5% iOS / 15% Android)
+
+| Check | What to look for |
+|-------|-----------------|
+| First 3 lines | Compelling hook above the fold? |
+| Feature highlights | Clear benefits, not just features? |
+| Keyword density (Android) | Natural keyword usage throughout? |
+| Formatting | Uses line breaks, bullets, or emoji for readability? |
+| Call to action | Ends with a clear CTA? |
+| Social proof | Mentions awards, press, or user count? |
+
+### 5. Screenshots (Weight: 15%)
+
+| Check | What to look for |
+|-------|-----------------|
+| Count | All 10 slots used? |
+| First 3 | Most compelling features shown first? |
+| Text overlays | Clear, readable benefit-driven captions? |
+| Consistency | Cohesive design language? |
+| Localization | Localized for target market? |
+| Device frames | Modern device frames (or frameless)? |
+
+### 6. App Preview Video (Weight: 5%)
+
+| Check | What to look for |
+|-------|-----------------|
+| Exists | Has a preview video? |
+| First 3 seconds | Hook in the first 3 seconds? |
+| Length | 15-30 seconds optimal? |
+| Sound | Works without sound (captions)? |
+
+### 7. Ratings & Reviews (Weight: 15%)
+
+| Check | What to look for |
+|-------|-----------------|
+| Average rating | 4.5+ stars? |
+| Rating count | Sufficient for category? |
+| Recent reviews | Positive trend in last 30 days? |
+| Review responses | Developer responds to negative reviews? |
+| Rating prompts | Strategic in-app rating prompts? |
+
+### 8. Icon (Weight: 5%)
+
+| Check | What to look for |
+|-------|-----------------|
+| Distinctiveness | Stands out in search results? |
+| Simplicity | Clear at small sizes? |
+| Category fit | Matches category expectations? |
+| No text | Avoids text (unreadable at small sizes)? |
+
+### 9. Keyword Rankings (Weight: 10%)
+
+| Check | What to look for |
+|-------|-----------------|
+| Top 10 keywords | Ranking in top 10 for target keywords? |
+| Keyword coverage | Ranking for enough relevant keywords? |
+| Trend | Rankings improving or declining? |
+| Competitor gap | Missing keywords competitors rank for? |
+
+### 10. Conversion Signals (Weight: 5%)
+
+| Check | What to look for |
+|-------|-----------------|
+| Promotional text | Using promotional text for timely messaging? |
+| What's New | Recent, informative update notes? |
+| In-App Events | Using in-app events for visibility? |
+| Custom Product Pages | Multiple product pages for different audiences? |
+
+## Output Format
+
+### ASO Score Card
+
+```
+Overall ASO Score: [X]/100
+
+Title:              [X]/10  ████████░░
+Subtitle:           [X]/10  ██████░░░░
+Keyword Field:      [X]/10  ████░░░░░░
+Description:        [X]/10  ████████░░
+Screenshots:        [X]/10  ██████████
+Preview Video:      [X]/10  ██░░░░░░░░
+Ratings & Reviews:  [X]/10  ████████░░
+Icon:               [X]/10  ████████░░
+Keyword Rankings:   [X]/10  ██████░░░░
+Conversion Signals: [X]/10  ████░░░░░░
+```
+
+### Quick Wins (implement today)
+
+List 3-5 changes that can be made immediately with high impact.
+
+### High-Impact Changes (this week)
+
+List 3-5 changes that require more effort but have significant impact.
+
+### Strategic Recommendations (this month)
+
+List 3-5 longer-term strategic improvements.
+
+### Competitor Comparison
+
+Brief comparison table showing how the app stacks up against top 3 competitors on key metrics.
+
+## Related Skills
+
+- `keyword-research` — Deep dive into keyword opportunities found during audit
+- `metadata-optimization` — Implement the metadata improvements identified
+- `screenshot-optimization` — Redesign screenshots based on audit findings
+- `competitor-analysis` — Detailed competitive analysis
+- `review-management` — Address review issues found in audit

package/skills/competitor-analysis/SKILL.md

@@ -0,0 +1,163 @@
+---
+name: competitor-analysis
+description: 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.
+metadata:
+  version: 1.0.0
+---
+
+# Competitor Analysis
+
+You are an expert in competitive intelligence for mobile apps. Your goal is to perform a thorough analysis of the user's competitors and identify actionable opportunities to outperform them.
+
+## Initial Assessment
+
+1. Check for `app-marketing-context.md` — read it for known competitors
+2. Ask for the **user's App ID**
+3. Ask for **competitor App IDs** (or help identify competitors)
+4. Ask for **target country** (default: US)
+5. Ask what they want to learn: keyword gaps, creative strategy, positioning, or all
+
+## Competitor Identification
+
+If the user doesn't know their competitors, find them through:
+
+1. **Category chart** — Top apps in the same category
+2. **Keyword overlap** — Apps ranking for the same keywords
+3. **Similar apps** — Apple's "You Might Also Like" section
+4. **User perception** — Ask "What would your users use if your app didn't exist?"
+
+Recommend analyzing 3-5 competitors: 2 direct competitors, 1-2 aspirational (larger), 1 emerging.
+
+## Analysis Framework
+
+### 1. Metadata Comparison
+
+| Element | Your App | Competitor 1 | Competitor 2 | Competitor 3 |
+|---------|----------|-------------|-------------|-------------|
+| Title | | | | |
+| Subtitle | | | | |
+| Title keywords | | | | |
+| Char usage (title) | /30 | /30 | /30 | /30 |
+| Char usage (subtitle) | /30 | /30 | /30 | /30 |
+| Description hook | | | | |
+
+**Analyze:**
+- What keywords do competitors prioritize in their title?
+- How do they balance brand vs keywords?
+- What positioning angle does each take?
+- What's their description hook strategy?
+
+### 2. Keyword Gap Analysis
+
+**Keywords only competitors rank for (you don't):**
+
+| Keyword | Volume | Difficulty | Comp 1 Rank | Comp 2 Rank | Your Rank | Priority |
+|---------|--------|------------|-------------|-------------|-----------|----------|
+
+**Keywords you rank for but competitors don't:**
+
+These are your unique advantages — protect them.
+
+**Keywords where you're outranked:**
+
+| Keyword | Your Rank | Best Competitor Rank | Gap | Effort to Close |
+|---------|-----------|---------------------|-----|-----------------|
+
+### 3. Creative Strategy
+
+**Screenshots:**
+- How many do they use? (target: 10)
+- What's their first screenshot? (hook)
+- Do they use text overlays?
+- What features do they highlight first?
+- Design style: dark/light, device frames, lifestyle?
+- Do they use portrait or landscape?
+
+**App Preview Video:**
+- Do they have one?
+- What's the hook?
+- How long is it?
+
+**Icon:**
+- Color scheme and style
+- How does it stand out in search results?
+
+### 4. Ratings & Reviews
+
+| Metric | Your App | Comp 1 | Comp 2 | Comp 3 |
+|--------|----------|--------|--------|--------|
+| Rating | | | | |
+| Total reviews | | | | |
+| Recent trend | | | | |
+| Top complaint | | | | |
+| Top praise | | | | |
+| Dev responds? | | | | |
+
+**Analyze:**
+- What do users love about competitors? (feature opportunities)
+- What do users hate? (your advantage if you solve it)
+- How do competitors handle negative reviews?
+
+### 5. Growth Signals
+
+| Signal | Your App | Comp 1 | Comp 2 | Comp 3 |
+|--------|----------|--------|--------|--------|
+| Chart position | | | | |
+| Downloads/mo (est) | | | | |
+| Revenue/mo (est) | | | | |
+| Update frequency | | | | |
+| In-app events? | | | | |
+| Custom pages? | | | | |
+| Apple Search Ads? | | | | |
+
+### 6. Monetization Comparison
+
+| Aspect | Your App | Comp 1 | Comp 2 | Comp 3 |
+|--------|----------|--------|--------|--------|
+| Price model | | | | |
+| Subscription price | | | | |
+| Free trial length | | | | |
+| IAP count | | | | |
+| Paywall timing | | | | |
+
+## Output Format
+
+### Executive Summary
+
+2-3 paragraphs summarizing the competitive landscape, your position, and the biggest opportunities.
+
+### Competitive Position Map
+
+```
+                    HIGH VISIBILITY
+                         │
+            Comp 1 ●     │     ● Comp 2
+                         │
+   LOW ──────────────────┼────────────────── HIGH
+   RATINGS               │               RATINGS
+                         │
+                  You ●  │
+                         │
+                    LOW VISIBILITY
+```
+
+### Top Opportunities
+
+1. **Quick Win:** [something you can do this week]
+2. **Keyword Gap:** [specific keywords to target]
+3. **Creative Edge:** [screenshot/video improvement]
+4. **Feature Gap:** [what users want that competitors don't offer]
+5. **Market Gap:** [underserved segment or country]
+
+### Threats to Monitor
+
+- [competitor moves to watch]
+- [market trends that could shift dynamics]
+
+## Related Skills
+
+- `keyword-research` — Deep dive into keyword gaps identified
+- `metadata-optimization` — Implement competitive insights into your metadata
+- `screenshot-optimization` — Redesign based on competitive creative analysis
+- `aso-audit` — Audit your own listing with competitive context
+- `ua-campaign` — Competitive paid acquisition strategy

package/skills/competitor-tracking/SKILL.md

@@ -0,0 +1,185 @@
+---
+name: competitor-tracking
+description: When the user wants to monitor competitor apps on an ongoing basis — tracking metadata changes, keyword shifts, screenshot updates, rating trends, or new features. Use when the user mentions "competitor monitoring", "track competitors", "competitor alert", "competitor changed their title", "watch a competitor app", "competitor weekly report", "competitive intelligence", or "what changed in competitor's listing". For a one-time deep competitive analysis, see competitor-analysis. For market-wide chart movements, see market-movers.
+metadata:
+  version: 1.0.0
+---
+
+# Competitor Tracking
+
+You set up and run ongoing competitor surveillance — catching metadata changes, keyword shifts, rating drops, and new feature launches before they impact your rankings.
+
+## One-Time Analysis vs Ongoing Tracking
+
+| | `competitor-analysis` skill | This skill (`competitor-tracking`) |
+|---|---|---|
+| **Frequency** | One-time deep dive | Weekly/monthly recurring |
+| **Output** | Strategy document | Change log + alerts |
+| **Focus** | Gap analysis, positioning | What changed and why it matters |
+| **Data** | Snapshot | Delta (before vs after) |
+
+## Setup: Define Your Watchlist
+
+1. Check for `app-marketing-context.md`
+2. Ask: **Who are your top 3–5 competitors?** (get App IDs if possible)
+3. Ask: **How often do you want to review?** (weekly recommended)
+4. Ask: **What are you most concerned about?** (keywords, ratings, creative, pricing)
+
+Use Appeeky to identify competitors if unknown:
+```bash
+GET /v1/keywords/ranks?keyword=meditation&country=us&limit=10
+GET /v1/apps/:id/intelligence  # check competitors array
+```
+
+## What to Track
+
+### Metadata Changes
+
+Check weekly using Appeeky:
+```bash
+GET /v1/apps/:id  # title, subtitle, description
+```
+
+Watch for:
+- **Title changes** — new keyword being targeted, repositioning
+- **Subtitle changes** — testing new hooks or keywords
+- **Description changes** — messaging strategy shift (Google Play especially)
+- **Screenshot updates** — new creative direction or A/B test winner shipped
+
+### Keyword Ranking Changes
+
+```bash
+GET /v1/apps/:id/keywords  # their ranking keywords
+GET /v1/keywords/ranks?keyword=[shared keyword]  # who's ranking where
+```
+
+Watch for:
+- Keywords they're newly ranking for (they optimized for this — should you?)
+- Keywords they dropped (opportunity to capture)
+- A competitor jumping above you for a shared keyword
+
+### Ratings and Reviews
+
+```bash
+GET /v1/apps/:id/reviews?sort=recent&limit=20
+GET /v1/apps/:id  # current rating
+```
+
+Watch for:
+- Rating drop (they shipped a bad update — opportunity to highlight your stability)
+- Surge of 1-stars around a specific complaint (user pain point you could solve)
+- New positive reviews praising a feature you don't have
+
+### Chart Positions
+
+```bash
+GET /v1/market/movers?genre=[genre_id]&country=us
+GET /v1/categories/:id/top?country=us&limit=25
+```
+
+Watch for:
+- A competitor entering or exiting top 10 in your category
+- New competitor entering your space from a chart rise
+
+### Pricing and Paywall
+
+Manually check every 4–6 weeks:
+- Trial length changes
+- Price changes (lower = aggressive growth; higher = LTV optimization)
+- New paywall format or plans
+
+## Weekly Competitive Report Template
+
+Run this analysis every Monday:
+
+```
+Competitive Update — Week of [Date]
+
+Apps tracked: [list names]
+
+CHANGES DETECTED:
+━━━━━━━━━━━━━━━━━
+[Competitor Name]
+  Metadata: [changed / no change]
+    → [specific change if any]
+  Top keywords: [gained X / lost Y / stable]
+  Rating: [X.X → X.X] ([+/-N] ratings this week)
+  Chart position: [#N → #N in category]
+  New reviews theme: [if notable]
+
+[Repeat per competitor]
+
+OPPORTUNITIES IDENTIFIED:
+1. [Competitor X dropped keyword Y — consider targeting it]
+2. [Competitor X has surge of complaints about Z — your strength]
+3. [Competitor X raised price — positioning opportunity]
+
+THREATS:
+1. [Competitor X now ranks #3 for [keyword] — we're at #8]
+2. [New entrant spotted: [name] — check their metadata]
+
+ACTION ITEMS:
+1. [Specific response to a change]
+2. [Keyword to target based on competitor gap]
+```
+
+## Monthly Deep-Dive Triggers
+
+Run a full `competitor-analysis` when:
+- A competitor jumps 10+ positions in the category chart
+- A competitor changes their title (signals major repositioning)
+- A new competitor enters the top 10 in your category
+- Your ranking drops on a keyword a competitor recently targeted
+
+## Automation Options
+
+### Manual (recommended for small teams)
+
+Set a calendar reminder. Run the Appeeky API calls above. Fill the template.
+
+### Semi-automated
+
+Build a script that calls Appeeky weekly and diffs results:
+
+```bash
+#!/bin/bash
+APPS=("6759740679" "987654321" "111222333")
+KEY="apk_your_key"
+
+for APP_ID in "${APPS[@]}"; do
+  echo "=== $APP_ID ==="
+  curl -s "https://api.appeeky.com/v1/apps/$APP_ID" \
+    -H "X-API-Key: $KEY" | jq '.data | {title, subtitle, rating, reviewCount}'
+done
+```
+
+Store results weekly and diff with the previous week's output.
+
+### Appeeky MCP (in Claude/Cursor)
+
+Ask your agent each Monday:
+```
+"Run a competitor check on apps [ID1], [ID2], [ID3] and 
+compare their metadata and top keywords to last week."
+```
+
+The agent will use `get_app`, `get_app_keywords`, `get_app_reviews` to produce the report.
+
+## Competitive Response Playbook
+
+| What changed | Response |
+|-------------|---------|
+| Competitor targets your #1 keyword in title | Defend: check your metadata is fully optimized; consider increasing ASA bids |
+| Competitor drops a keyword you share | Opportunity: double down, increase bid in ASA |
+| Competitor upgrades screenshots | Audit yours — are they still best in category? |
+| Competitor rating drops below 4.0 | Mention your rating in promotional text while gap is visible |
+| Competitor launches a feature you don't have | Note for roadmap; meanwhile highlight your differentiating strengths |
+| New competitor enters top 10 | Run full `competitor-analysis` on them |
+
+## Related Skills
+
+- `competitor-analysis` — Deep one-time competitive strategy
+- `keyword-research` — Act on the keyword gaps you find
+- `market-movers` — Catch chart-level competitor movements automatically
+- `apple-search-ads` — Respond to competitor keyword moves with ASA bids
+- `aso-audit` — Run on yourself after finding competitive gaps