App Store Optimization (ASO)

Workspace Context

Read bootstrap context before asking questions: strategy/brand.md for brand, audience, offer, channels, tools, constraints, and metrics; about/me.md for personal voice; content/ideas.md and content/calendar.md for content planning. Use legacy product-marketing context files only as fallback. Save generated drafts to content/<platform>/drafts/YYYY-MM-DD_short-topic-slug.md, and route durable learnings back to strategy/brand.md, about/me.md, or content/ideas.md.

Operating Contract

This skill is self-contained for its frontmatter scope: use its local instructions, references, scripts, and assets as the playbook; ask only for missing task-specific inputs; hand off to adjacent skills instead of expanding scope; and return an actionable artifact, decision, plan, draft, or diagnostic.

ASO tools for researching keywords, optimizing metadata, analyzing competitors, and improving app store visibility on Apple App Store and Google Play Store.

Keyword Research Workflow

Discover and evaluate keywords that drive app store visibility.

Workflow: Conduct Keyword Research

1. Define target audience and core app functions:
   • Primary use case (what problem does the app solve)
   • Target user demographics
   • Competitive category
2. Generate seed keywords from:
   • App features and benefits
   • User language (not developer terminology)
   • App store autocomplete suggestions
3. Expand keyword list using:
   • Modifiers (free, best, simple)
   • Actions (create, track, organize)
   • Audiences (for students, for teams, for business)
4. Evaluate each keyword:
   • Search volume (estimated monthly searches)
   • Competition (number and quality of ranking apps)
   • Relevance (alignment with app function)
5. Score and prioritize keywords:
   • Primary: Title and keyword field (iOS)
   • Secondary: Subtitle and short description
   • Tertiary: Full description only
6. Map keywords to metadata locations
7. Document keyword strategy for tracking
8. Validation: Keywords scored; placement mapped; no competitor brand names included; no plurals in iOS keyword field

Keyword Evaluation Criteria

Keyword Placement Priority

See: references/keyword-research-guide.md

---

Metadata Optimization Workflow

Optimize app store listing elements for search ranking and conversion.

Workflow: Optimize App Metadata

1. Audit current metadata against platform limits:
   • Title character count and keyword presence
   • Subtitle/short description usage
   • Keyword field efficiency (iOS)
   • Description keyword density
2. Optimize title following formula:

   [Brand Name] - [Primary Keyword] [Secondary Keyword]
   

3. Write subtitle (iOS) or short description (Android):
   • Focus on primary benefit
   • Include secondary keyword
   • Use action verbs
4. Optimize keyword field (iOS only):
   • Remove duplicates from title
   • Remove plurals (Apple indexes both forms)
   • No spaces after commas
   • Prioritize by score
5. Rewrite full description:
   • Hook paragraph with value proposition
   • Feature bullets with keywords
   • Social proof section
   • Call to action
6. Validate character counts for each field
7. Calculate keyword density (target 2-3% primary)
8. Validation: All fields within character limits; primary keyword in title; no keyword stuffing (>5%); natural language preserved

Platform Character Limits

Description Structure

PARAGRAPH 1: Hook (50-100 words)
├── Address user pain point
├── State main value proposition
└── Include primary keyword

PARAGRAPH 2-3: Features (100-150 words)
├── Top 5 features with benefits
├── Bullet points for scanability
└── Secondary keywords naturally integrated

PARAGRAPH 4: Social Proof (50-75 words)
├── Download count or rating
├── Press mentions or awards
└── Summary of user testimonials

PARAGRAPH 5: Call to Action (25-50 words)
├── Clear next step
└── Reassurance (free trial, no signup)

See: references/platform-requirements.md

---

Competitor Analysis Workflow

Analyze top competitors to identify keyword gaps and positioning opportunities.

Workflow: Analyze Competitor ASO Strategy

1. Identify top 10 competitors:
   • Direct competitors (same core function)
   • Indirect competitors (overlapping audience)
   • Category leaders (top downloads)
2. Extract competitor keywords from:
   • App titles and subtitles
   • First 100 words of descriptions
   • Visible metadata patterns
3. Build competitor keyword matrix:
   • Map which keywords each competitor targets
   • Calculate coverage percentage per keyword
4. Identify keyword gaps:
   • Keywords with <40% competitor coverage
   • High volume terms competitors miss
   • Long-tail opportunities
5. Analyze competitor visual assets:
   • Icon design patterns
   • Screenshot messaging and style
   • Video presence and quality
6. Compare ratings and review patterns:
   • Average rating by competitor
   • Common praise themes
   • Common complaint themes
7. Document positioning opportunities
8. Validation: 10+ competitors analyzed; keyword matrix complete; gaps identified with volume estimates; visual audit documented

Competitor Analysis Matrix

Gap Analysis Template

---

App Launch Workflow

Execute a structured launch for maximum initial visibility.

Workflow: Launch App to Stores

1. Complete pre-launch preparation (4 weeks before):
   • Finalize keywords and metadata
   • Prepare all visual assets
   • Set up analytics (Firebase, Mixpanel)
   • Build press kit and media list
2. Submit for review (2 weeks before):
   • Complete all store requirements
   • Verify compliance with guidelines
   • Prepare launch communications
3. Configure post-launch systems:
   • Set up review monitoring
   • Prepare response templates
   • Configure rating prompt timing
4. Execute launch day:
   • Verify app is live in both stores
   • Announce across all channels
   • Begin review response cycle
5. Monitor initial performance (days 1-7):
   • Track download velocity hourly
   • Monitor reviews and respond within 24 hours
   • Document any issues for quick fixes
6. Conduct 7-day retrospective:
   • Compare performance to projections
   • Identify quick optimization wins
   • Plan first metadata update
7. Schedule first update (2 weeks post-launch)
8. Validation: App live in stores; analytics tracking; review responses within 24h; download velocity documented; first update scheduled

Pre-Launch Checklist

Launch Timing Considerations

See: references/aso-best-practices.md

---

A/B Testing Workflow

Test metadata and visual elements to improve conversion rates.

Workflow: Run A/B Test

1. Select test element (prioritize by impact):
   • Icon (highest impact)
   • Screenshot 1 (high impact)
   • Title (high impact)
   • Short description (medium impact)
2. Form hypothesis:

   If we [change], then [metric] will [improve/increase] by [amount]
   because [rationale].
   

3. Create variants:
   • Control: Current version
   • Treatment: Single variable change
4. Calculate required sample size:
   • Baseline conversion rate
   • Minimum detectable effect (usually 5%)
   • Statistical significance (95%)
5. Launch test:
   • Apple: Use Product Page Optimization
   • Android: Use Store Listing Experiments
6. Run test for minimum duration:
   • At least 7 days
   • Until statistical significance reached
7. Analyze results:
   • Compare conversion rates
   • Check statistical significance
   • Document learnings
8. Validation: Single variable tested; sample size sufficient; significance reached (95%); results documented; winner implemented

A/B Test Prioritization

Sample Size Quick Reference

Test Documentation Template

TEST ID: ASO-2025-001
ELEMENT: App Icon
HYPOTHESIS: A bolder color icon will increase conversion by 10%
START DATE: [Date]
END DATE: [Date]

RESULTS:
├── Control CVR: 4.2%
├── Treatment CVR: 4.8%
├── Lift: +14.3%
├── Significance: 97%
└── Decision: Implement treatment

LEARNINGS:
- Bold colors outperform muted tones in this category
- Apply to screenshot backgrounds for next test

---

Before/After Examples

Title Optimization

Productivity App:

Fitness App:

Subtitle Optimization (iOS)

Keyword Field Optimization (iOS)

Before (Inefficient - 89 chars, 8 keywords):

task manager, todo list, productivity app, daily planner, reminder app

After (Optimized - 97 chars, 14 keywords):

task,todo,checklist,reminder,organize,daily,planner,schedule,deadline,goals,habit,widget,sync,team

Improvements:

• Removed spaces after commas (+8 chars)
• Removed duplicates (task manager → task)
• Removed plurals (reminders → reminder)
• Removed words in title
• Added more relevant keywords

Description Opening

Before:

MyTasks is a comprehensive task management solution designed
to help busy professionals organize their daily activities
and boost productivity.

After:

Forget missed deadlines. MyTasks keeps every task, reminder,
and project in one place—so you focus on doing, not remembering.
Trusted by 500,000+ professionals.

Improvements:

• Leads with user pain point
• Specific benefit (not generic "boost productivity")
• Social proof included
• Keywords natural, not stuffed

Screenshot Caption Evolution

---

Tools and References

Scripts

References

Assets

---

Platform Limitations

Data Constraints

Platform Behavior

When Not to Use This Skill

---

Related Skills

---

Supporting file: HOW_TO_USE.md

How to Use the App Store Optimization Skill

Hey Claude—I just added the "app-store-optimization" skill. Can you help me optimize my app's presence on the App Store and Google Play?

Example Invocations

Keyword Research

Example 1: Basic Keyword Research

Hey Claude—I just added the "app-store-optimization" skill. Can you research the best keywords for my productivity app? I'm targeting professionals who need task management and team collaboration features.

Example 2: Competitive Keyword Analysis

Hey Claude—I just added the "app-store-optimization" skill. Can you analyze keywords that Todoist, Asana, and Monday.com are using? I want to find gaps and opportunities for my project management app.

Metadata Optimization

Example 3: Optimize App Title

Hey Claude—I just added the "app-store-optimization" skill. Can you optimize my app title for the Apple App Store? My app is called "TaskFlow" and I want to rank for "task manager", "productivity", and "team collaboration". The title needs to be under 30 characters.

Example 4: Full Metadata Package

Hey Claude—I just added the "app-store-optimization" skill. Can you create optimized metadata for both Apple App Store and Google Play Store? Here's my app info:
- Name: TaskFlow
- Category: Productivity
- Key features: AI task prioritization, team collaboration, calendar integration
- Target keywords: task manager, productivity app, team tasks

Competitor Analysis

Example 5: Analyze Top Competitors

Hey Claude—I just added the "app-store-optimization" skill. Can you analyze the ASO strategies of the top 5 productivity apps in the App Store? I want to understand their title strategies, keyword usage, and visual asset approaches.

Example 6: Identify Competitive Gaps

Hey Claude—I just added the "app-store-optimization" skill. Can you compare my app's ASO performance against competitors and identify what I'm missing? Here's my current metadata: [paste metadata]

ASO Score Calculation

Example 7: Calculate Overall ASO Health

Hey Claude—I just added the "app-store-optimization" skill. Can you calculate my app's ASO health score? Here are my metrics:
- Average rating: 4.2 stars
- Total ratings: 3,500
- Keywords in top 10: 3
- Keywords in top 50: 12
- Conversion rate: 4.5%

Example 8: Identify Improvement Areas

Hey Claude—I just added the "app-store-optimization" skill. My ASO score is 62/100. Can you tell me which areas I should focus on first to improve my rankings and downloads?

A/B Testing

Example 9: Plan Icon Test

Hey Claude—I just added the "app-store-optimization" skill. I want to A/B test two different app icons. My current conversion rate is 5%. Can you help me plan the test, calculate required sample size, and determine how long to run it?

Example 10: Analyze Test Results

Hey Claude—I just added the "app-store-optimization" skill. Can you analyze my A/B test results?
- Variant A (control): 2,500 visitors, 125 installs
- Variant B (new icon): 2,500 visitors, 150 installs
Is this statistically significant? Should I implement variant B?

Localization

Example 11: Plan Localization Strategy

Hey Claude—I just added the "app-store-optimization" skill. I currently only have English metadata. Which markets should I localize for first? I'm a bootstrapped startup with moderate budget.

Example 12: Translate Metadata

Hey Claude—I just added the "app-store-optimization" skill. Can you help me translate my app metadata to Spanish for the Mexico market? Here's my English metadata: [paste metadata]. Check if it fits within character limits.

Review Analysis

Example 13: Analyze User Reviews

Hey Claude—I just added the "app-store-optimization" skill. Can you analyze my recent reviews and tell me:
- Overall sentiment (positive/negative ratio)
- Most common complaints
- Most requested features
- Bugs that need immediate fixing

Example 14: Generate Review Response Templates

Hey Claude—I just added the "app-store-optimization" skill. Can you create professional response templates for:
- Users reporting crashes
- Feature requests
- Positive 5-star reviews
- General complaints

Launch Planning

Example 15: Pre-Launch Checklist

Hey Claude—I just added the "app-store-optimization" skill. Can you generate a comprehensive pre-launch checklist for both Apple App Store and Google Play Store? My launch date is December 1, 2025.

Example 16: Optimize Launch Timing

Hey Claude—I just added the "app-store-optimization" skill. What's the best day and time to launch my fitness app? I want to maximize visibility and downloads in the first week.

Example 17: Plan Seasonal Campaign

Hey Claude—I just added the "app-store-optimization" skill. Can you identify seasonal opportunities for my fitness app? It's currently October—what campaigns should I run for the next 6 months?

What to Provide

For Keyword Research

• App name and category
• Target audience description
• Key features and unique value proposition
• Competitor apps (optional)
• Geographic markets to target

For Metadata Optimization

• Current app name
• Platform (Apple, Google, or both)
• Target keywords (prioritized list)
• Key features and benefits
• Target audience
• Current metadata (for optimization)

For Competitor Analysis

• Your app category
• List of competitor app names or IDs
• Platform (Apple or Google)
• Specific aspects to analyze (keywords, visuals, ratings)

For ASO Score Calculation

• Metadata quality metrics (title length, description length, keyword density)
• Rating data (average rating, total ratings, recent ratings)
• Keyword rankings (top 10, top 50, top 100 counts)
• Conversion metrics (impression-to-install rate, downloads)

For A/B Testing

• Test type (icon, screenshot, title, description)
• Control variant details
• Test variant details
• Baseline conversion rate
• For results analysis: visitor and conversion counts for both variants

For Localization

• Current market and language
• Budget level (low, medium, high)
• Target number of markets
• Current metadata text for translation

For Review Analysis

• Recent reviews (text, rating, date)
• Platform (Apple or Google)
• Time period to analyze
• Specific focus (bugs, features, sentiment)

For Launch Planning

• Platform (Apple, Google, or both)
• Target launch date
• App category
• App information (name, features, target audience)

What You'll Get

Keyword Research Output

• Prioritized keyword list with search volume estimates
• Competition level analysis
• Relevance scores
• Long-tail keyword opportunities
• Strategic recommendations

Metadata Optimization Output

• Optimized titles (multiple options)
• Optimized descriptions (short and full)
• Keyword field optimization (Apple)
• Character count validation
• Keyword density analysis
• Before/after comparison

Competitor Analysis Output

• Ranked competitors by ASO strength
• Common keyword patterns
• Keyword gaps and opportunities
• Visual asset assessment
• Best practices identified
• Actionable recommendations

ASO Score Output

• Overall score (0-100)
• Breakdown by category (metadata, ratings, keywords, conversion)
• Strengths and weaknesses
• Prioritized action items
• Expected impact of improvements

A/B Test Output

• Test design with hypothesis
• Required sample size calculation
• Duration estimates
• Statistical significance analysis
• Implementation recommendations
• Learnings and insights

Localization Output

• Prioritized target markets
• Estimated translation costs
• ROI projections
• Character limit validation for each language
• Cultural adaptation recommendations
• Phased implementation plan

Review Analysis Output

• Sentiment distribution (positive/neutral/negative)
• Common themes and topics
• Top issues requiring fixes
• Most requested features
• Response templates
• Trend analysis over time

Launch Planning Output

• Platform-specific checklists (Apple, Google, Universal)
• Timeline with milestones
• Compliance validation
• Optimal launch timing recommendations
• Seasonal campaign opportunities
• Update cadence planning

Tips for Best Results

1. Be Specific: Provide as much detail about your app as possible
2. Include Context: Share your goals (increase downloads, improve ranking, boost conversion)
3. Provide Data: Real metrics enable more accurate analysis
4. Iterate: Start with keyword research, then optimize metadata, then test
5. Track Results: Monitor changes after implementing recommendations
6. Stay Compliant: Always verify recommendations against current App Store/Play Store guidelines
7. Test First: Use A/B testing before making major metadata changes
8. Localize Strategically: Start with highest-ROI markets first
9. Respond to Reviews: Use provided templates to engage with users
10. Plan Ahead: Use launch checklists and timelines to avoid last-minute rushes

Common Workflows

New App Launch

1. Keyword research → Competitor analysis → Metadata optimization → Pre-launch checklist → Launch timing optimization

Improving Existing App

1. ASO score calculation → Identify gaps → Metadata optimization → A/B testing → Review analysis → Implement changes

International Expansion

1. Localization planning → Market prioritization → Metadata translation → ROI analysis → Phased rollout

Ongoing Optimization

1. Monthly keyword ranking tracking → Quarterly metadata updates → Continuous A/B testing → Review monitoring → Seasonal campaigns

Need Help?

If you need clarification on any aspect of ASO or want to combine multiple analyses, just ask! For example:

Hey Claude—I just added the "app-store-optimization" skill. Can you create a complete ASO strategy for my new productivity app? I need keyword research, optimized metadata for both stores, a pre-launch checklist, and launch timing recommendations.

The skill can handle comprehensive, multi-phase ASO projects as well as specific tactical optimizations.

---

Supporting file: assets/aso-audit-template.md

ASO Audit Template

Use this template to conduct a systematic App Store Optimization audit.

---

App Information

---

Metadata Audit

Title Analysis

Title Score: ___/10

Recommendations:

• [ ]
• [ ]

Subtitle / Short Description

Score: ___/10

Recommendations:

• [ ]
• [ ]

Keyword Field (iOS Only)

Score: ___/10

Recommendations:

• [ ]
• [ ]

Full Description

Score: ___/10

Recommendations:

• [ ]
• [ ]

---

Visual Asset Audit

App Icon

Score: ___/10

Recommendations:

• [ ]
• [ ]

Screenshots

Overall Screenshot Score: ___/10

Recommendations:

• [ ]
• [ ]

App Preview Video

Score: ___/10

---

Keyword Performance Audit

Current Keyword Rankings

Keyword Opportunities

---

Rating & Review Audit

Rating Summary

Review Analysis

Response Rate

Rating Score: ___/10

Recommendations:

• [ ]
• [ ]

---

Competitor Comparison

Top 3 Competitors

Competitive Gaps

---

Overall ASO Score

---

Priority Action Items

High Priority (This Week)

1. [ ]
2. [ ]
3. [ ]

Medium Priority (This Month)

1. [ ]
2. [ ]
3. [ ]

Low Priority (This Quarter)

1. [ ]
2. [ ]
3. [ ]

---

Audit Sign-Off

---

Notes

Additional observations and context:

---

Supporting file: expected_output.json

{
  "request_type": "keyword_research",
  "app_name": "TaskFlow Pro",
  "keyword_analysis": {
    "total_keywords_analyzed": 25,
    "primary_keywords": [
      {
        "keyword": "task manager",
        "search_volume": 45000,
        "competition_level": "high",
        "relevance_score": 0.95,
        "difficulty_score": 72.5,
        "potential_score": 78.3,
        "recommendation": "High priority - target immediately"
      },
      {
        "keyword": "productivity app",
        "search_volume": 38000,
        "competition_level": "high",
        "relevance_score": 0.90,
        "difficulty_score": 68.2,
        "potential_score": 75.1,
        "recommendation": "High priority - target immediately"
      },
      {
        "keyword": "todo list",
        "search_volume": 52000,
        "competition_level": "very_high",
        "relevance_score": 0.85,
        "difficulty_score": 78.9,
        "potential_score": 71.4,
        "recommendation": "High priority - target immediately"
      }
    ],
    "secondary_keywords": [
      {
        "keyword": "team task manager",
        "search_volume": 8500,
        "competition_level": "medium",
        "relevance_score": 0.88,
        "difficulty_score": 42.3,
        "potential_score": 68.7,
        "recommendation": "Good opportunity - include in metadata"
      },
      {
        "keyword": "project planning app",
        "search_volume": 12000,
        "competition_level": "medium",
        "relevance_score": 0.75,
        "difficulty_score": 48.1,
        "potential_score": 64.2,
        "recommendation": "Good opportunity - include in metadata"
      }
    ],
    "long_tail_keywords": [
      {
        "keyword": "ai task prioritization",
        "search_volume": 2800,
        "competition_level": "low",
        "relevance_score": 0.95,
        "difficulty_score": 25.4,
        "potential_score": 82.6,
        "recommendation": "Excellent long-tail opportunity"
      },
      {
        "keyword": "team productivity tool",
        "search_volume": 3500,
        "competition_level": "low",
        "relevance_score": 0.85,
        "difficulty_score": 28.7,
        "potential_score": 79.3,
        "recommendation": "Excellent long-tail opportunity"
      }
    ]
  },
  "competitor_insights": {
    "competitors_analyzed": 4,
    "common_keywords": [
      "task",
      "todo",
      "list",
      "productivity",
      "organize",
      "manage"
    ],
    "keyword_gaps": [
      {
        "keyword": "ai prioritization",
        "used_by": ["None of the major competitors"],
        "opportunity": "Unique positioning opportunity"
      },
      {
        "keyword": "smart task manager",
        "used_by": ["Things 3"],
        "opportunity": "Underutilized by most competitors"
      }
    ]
  },
  "metadata_recommendations": {
    "apple_app_store": {
      "title_options": [
        {
          "title": "TaskFlow - AI Task Manager",
          "length": 26,
          "keywords_included": ["task manager", "ai"],
          "strategy": "brand_plus_primary"
        },
        {
          "title": "TaskFlow: Smart Todo & Tasks",
          "length": 29,
          "keywords_included": ["todo", "tasks"],
          "strategy": "brand_plus_multiple"
        }
      ],
      "subtitle_recommendation": "AI-Powered Team Productivity",
      "keyword_field": "productivity,organize,planner,schedule,workflow,reminders,collaboration,calendar,sync,priorities",
      "description_focus": "Lead with AI differentiation, emphasize team features"
    },
    "google_play_store": {
      "title_options": [
        {
          "title": "TaskFlow - AI Task Manager & Team Productivity",
          "length": 48,
          "keywords_included": ["task manager", "ai", "team", "productivity"],
          "strategy": "keyword_rich"
        }
      ],
      "short_description_recommendation": "AI task manager - Organize, prioritize, and collaborate with your team",
      "description_focus": "Keywords naturally integrated throughout 4000 character description"
    }
  },
  "strategic_recommendations": [
    "Focus on 'AI prioritization' as unique differentiator - low competition, high relevance",
    "Target 'team task manager' and 'team productivity' keywords - good search volume, lower competition than generic terms",
    "Include long-tail keywords in description for additional discovery opportunities",
    "Test title variations with A/B testing after launch",
    "Monitor competitor keyword changes quarterly"
  ],
  "priority_actions": [
    {
      "action": "Optimize app title with primary keyword",
      "priority": "high",
      "expected_impact": "15-25% improvement in search visibility"
    },
    {
      "action": "Create description highlighting AI features with natural keyword integration",
      "priority": "high",
      "expected_impact": "10-15% improvement in conversion rate"
    },
    {
      "action": "Plan A/B tests for icon and screenshots post-launch",
      "priority": "medium",
      "expected_impact": "5-10% improvement in conversion rate"
    }
  ],
  "aso_health_estimate": {
    "current_score": "N/A (pre-launch)",
    "potential_score_with_optimizations": "75-80/100",
    "key_strengths": [
      "Unique AI differentiation",
      "Clear target audience",
      "Strong feature set"
    ],
    "areas_to_develop": [
      "Build rating volume post-launch",
      "Monitor and respond to reviews",
      "Continuous keyword optimization"
    ]
  }
}

---

Supporting file: references/aso-best-practices.md

ASO Best Practices Reference

Optimization strategies for improving app store visibility, conversion, and rankings.

---

Table of Contents

• Keyword Optimization (#keyword-optimization)
• Metadata Optimization (#metadata-optimization)
• Visual Asset Optimization (#visual-asset-optimization)
• Rating and Review Management (#rating-and-review-management)
• Launch Strategy (#launch-strategy)
• A/B Testing Framework (#ab-testing-framework)
• Conversion Optimization (#conversion-optimization)
• Common Mistakes to Avoid (#common-mistakes-to-avoid)

---

Keyword Optimization

Keyword Research Process

1. Brainstorm seed keywords - Core terms users search for
2. Expand with variations - Synonyms, related terms, long-tail
3. Analyze competition - Check difficulty scores
4. Evaluate search volume - Prioritize high-volume terms
5. Test and iterate - Monitor rankings and adjust

Keyword Selection Criteria

Keyword Placement Priority

Long-Tail Keyword Strategy

Long-tail keywords have lower volume but higher conversion:

Formula for keyword priority:

Score = (Volume × 0.3) + (1/Competition × 0.3) + (Relevance × 0.4)

---

Metadata Optimization

Title Optimization

Structure Formula:

[Brand Name] - [Primary Keyword] [Secondary Keyword/Benefit]

Examples by category:

Title Optimization Checklist:

• Primary keyword within first 3 words
• Brand name is memorable and unique
• Character count matches platform limit
• No keyword stuffing
• Readable and natural sounding

Description Optimization

Full Description Structure:

PARAGRAPH 1: Hook + Primary Benefit (50-100 words)
- Address user pain point
- State main value proposition
- Include primary keyword naturally

PARAGRAPH 2-3: Feature Highlights (100-150 words)
- Top 3-5 features with benefits
- Use bullet points or emojis for scanability
- Include secondary keywords

PARAGRAPH 4: Social Proof (50-75 words)
- Download numbers or ratings
- Press mentions or awards
- User testimonials (summarized)

PARAGRAPH 5: Call to Action (25-50 words)
- Clear next step
- Urgency or incentive
- Reassurance (free trial, no credit card)

Keyword Density Target:

• Primary keyword: 2-3% (8-12 mentions in 4000 chars)
• Secondary keywords: 1-2% each (4-8 mentions each)

Subtitle Optimization (iOS)

Effective Subtitle Formulas:

---

Visual Asset Optimization

App Icon Best Practices

Icon Testing Questions:

1. Is it recognizable at 29x29px (smallest iOS size)?
2. Does it stand out in search results?
3. Does it communicate app function?
4. Is it distinct from top 10 category competitors?

Screenshot Optimization

Screenshot Hierarchy:

Caption Best Practices:

• Maximum 5-7 words per caption
• Action-oriented verbs ("Track", "Organize", "Discover")
• Benefit-focused, not feature-focused
• Consistent typography and style

Example Caption Evolution:

Video Preview Strategy

Video Structure (30 seconds):

---

Rating and Review Management

Review Response Framework

For Negative Reviews (1-2 stars):

Structure:
1. Acknowledge the issue (1 sentence)
2. Apologize without making excuses (1 sentence)
3. Offer solution or next step (1-2 sentences)
4. Invite direct contact (1 sentence)

Example:
"We're sorry the syncing issues are affecting your experience.
Our team is actively working on a fix for the next update.
In the meantime, please try logging out and back in, which
resolves this for most users. If issues persist, email us at
support@app.com and we'll prioritize your case."

For Positive Reviews (4-5 stars):

Structure:
1. Thank sincerely (1 sentence)
2. Acknowledge specific praise (1 sentence)
3. Encourage continued use or sharing (1 sentence)

Example:
"Thank you for the kind words! We're thrilled the reminder
feature helps you stay organized. If you're enjoying the app,
we'd love if you'd share it with friends who might benefit."

Rating Improvement Tactics

Review Prompt Best Practices

When to prompt:

• After user completes 5+ successful sessions
• After milestone achievement (first task completed, 7-day streak)
• After positive in-app feedback ("Was this helpful? Yes")

When NOT to prompt:

• First session
• After error or crash
• During critical workflow
• More than once per 30 days

---

Launch Strategy

Pre-Launch Checklist

4 Weeks Before Launch:

• Finalize app name and keywords
• Complete all metadata fields
• Prepare all visual assets
• Set up analytics (Firebase, Mixpanel)
• Create press kit and media assets
• Build email list for launch notification

2 Weeks Before Launch:

• Submit for app review
• Prepare social media content
• Brief press and influencers
• Set up review response templates
• Configure in-app rating prompts

Launch Day:

• Verify app is live in stores
• Announce across all channels
• Monitor reviews and respond quickly
• Track download velocity
• Document any issues for Day 2 fix

Update Cadence

Seasonal Optimization

---

A/B Testing Framework

Test Prioritization Matrix

Sample Size Calculator

Formula:

Sample Size = (2 × (Z² × p × (1-p))) / E²

Where:
Z = 1.96 (for 95% confidence)
p = baseline conversion rate
E = minimum detectable effect (usually 0.05)

Quick Reference:

Test Duration Guidelines

---

Conversion Optimization

Conversion Funnel Metrics

Conversion Optimization Levers

---

Common Mistakes to Avoid

Keyword Mistakes

Metadata Mistakes

Visual Asset Mistakes

Launch Mistakes

---

Supporting file: references/keyword-research-guide.md

Keyword Research Guide

Systematic approach to discovering, evaluating, and selecting keywords for app store optimization.

---

Table of Contents

• Keyword Research Methodology (#keyword-research-methodology)
• Keyword Evaluation Framework (#keyword-evaluation-framework)
• Competitor Keyword Analysis (#competitor-keyword-analysis)
• Keyword Mapping Strategy (#keyword-mapping-strategy)
• Keyword Tracking and Iteration (#keyword-tracking-and-iteration)

---

Keyword Research Methodology

Phase 1: Seed Keyword Generation

Start by generating initial keyword ideas from multiple sources.

Source 1: Core App Functions

List every action or problem the app solves:

Example for a task management app:
- Create tasks
- Set reminders
- Track deadlines
- Organize projects
- Collaborate with team
- Plan daily schedule

Source 2: User Language Mapping

Match developer terminology to user searches:

Source 3: App Store Autocomplete

Type seed keywords into App Store/Play Store search and record suggestions:

"todo" → todo list, todo app, todo list app, todolist widget
"task" → task manager, task planner, task list, tasks to do
"remind" → reminder app, reminder, reminders widget, remind me

Source 4: Competitor Analysis

Extract keywords from top 10 competitors in category (detailed in section below).

Phase 2: Keyword Expansion

Expansion Techniques:

Keyword Matrix Template:

Phase 3: Keyword Filtering

Remove irrelevant or low-quality keywords:

Exclusion Criteria:

---

Keyword Evaluation Framework

Keyword Scoring Model

Evaluate each keyword on four dimensions:

1. Search Volume (0-100)

2. Competition (0-100, inverted)

3. Relevance (0-100)

4. Conversion Potential (0-100)

Composite Score Calculation

Keyword Score = (Volume × 0.25) + (Competition × 0.25) +
                (Relevance × 0.35) + (Conversion × 0.15)

Score Interpretation:

Keyword Evaluation Worksheet

KEYWORD EVALUATION

Keyword: "task manager app"
Date: [Date]

SCORES:
├── Search Volume: 72/100 (High - ~25,000/month)
├── Competition: 45/100 (Medium - 4.4 avg rating in top 10)
├── Relevance: 95/100 (Exact match to core function)
└── Conversion: 85/100 (Transactional intent)

COMPOSITE SCORE: 74.5/100

RECOMMENDATION: Secondary Priority
- Include in subtitle or short description
- Not competitive enough for title (dominated by Todoist, Any.do)
- Consider long-tail variant: "simple task manager app"

---

Competitor Keyword Analysis

Competitor Identification

Step 1: Direct Competitors Apps solving the same problem for the same audience.

Step 2: Indirect Competitors Apps solving related problems or targeting overlapping audiences.

Step 3: Category Leaders Top 10-20 apps by downloads in primary category.

Competitor Keyword Extraction

From App Title:

Competitor: "Todoist: To-Do List & Tasks"
Keywords: todoist, to-do list, tasks, to do

From Subtitle (iOS):

Competitor subtitle: "Task Manager & Planner"
Keywords: task manager, planner

From Description (First 100 words): Identify frequently used terms:

"Todoist is the world's favorite task manager and to-do list app.
Organize work and life, hit your goals, and find productivity..."

Extracted: task manager, to-do list, organize, goals, productivity

Competitor Keyword Matrix

Analysis:

• 100% coverage = Highly competitive, essential keyword
• 60-80% coverage = Important category term
• 40% coverage = Potential differentiator
• <40% coverage = Unique opportunity or irrelevant

Keyword Gap Analysis

Identify keywords competitors miss:

KEYWORD GAP ANALYSIS

Underserved Keywords (Low competitor coverage, decent volume):
1. "daily planner widget" - 2/10 competitors, 5,000 searches
2. "task list for teams" - 3/10 competitors, 3,500 searches
3. "todo with calendar sync" - 1/10 competitors, 2,800 searches

Opportunity Assessment:
- "daily planner widget" → Add widget feature, target keyword
- "task list for teams" → Already have feature, update metadata
- "todo with calendar sync" → Feature gap, add to roadmap

---

Keyword Mapping Strategy

Keyword Placement Map

Assign each keyword to specific metadata locations:

KEYWORD PLACEMENT MAP

PRIMARY (Title + Keyword Field):
├── task manager (Score: 82)
├── todo list (Score: 78)
└── planner (Score: 75)

SECONDARY (Subtitle + Short Description):
├── reminder app (Score: 68)
├── daily tasks (Score: 65)
└── organize (Score: 62)

TERTIARY (Full Description):
├── checklist (Score: 55)
├── productivity (Score: 52)
├── schedule (Score: 48)
├── deadline (Score: 45)
└── project management (Score: 42)

iOS Keyword Field Strategy

100 Character Optimization:

STEP 1: List all target keywords
task,manager,todo,list,planner,reminder,organize,daily,checklist,
productivity,schedule,deadline,project,goals,habit,widget,sync,
team,collaborate,notes,calendar

STEP 2: Remove duplicates from title
Title: "TaskFlow - Todo List Manager"
Remove: task, todo, list, manager

STEP 3: Remove plurals
Keep: reminder (not reminders)
Keep: goal (not goals)

STEP 4: Prioritize by score and fit
Final 100 chars:
planner,reminder,organize,daily,checklist,productivity,schedule,
deadline,project,goals,habit,widget,sync,team,collaborate

Character count: 98/100

Android Description Keyword Integration

Natural keyword placement in 4,000 characters:

PARAGRAPH 1 (Hook - 300 chars):
Keywords: task manager, todo list, organize
"TaskFlow is the task manager trusted by 2 million users. Create
your perfect todo list and organize everything that matters..."

PARAGRAPH 2 (Features - 800 chars):
Keywords: reminder, checklist, deadline, project
"Set smart reminders that notify you at the right time. Build
checklists for any project. Never miss a deadline with..."

PARAGRAPH 3 (Benefits - 600 chars):
Keywords: productivity, schedule, goals
"Boost your productivity with proven planning methods. Schedule
your day in minutes. Track goals and celebrate..."

PARAGRAPH 4 (Differentiators - 500 chars):
Keywords: widget, sync, team, collaborate
"Beautiful widgets keep tasks visible. Sync across all devices
instantly. Invite your team to collaborate on..."

Total keyword coverage: 14 keywords naturally integrated

---

Keyword Tracking and Iteration

Ranking Tracking Cadence

Keyword Performance Metrics

Iteration Process

Monthly Keyword Audit:

1. EXPORT current rankings
   - List all tracked keywords
   - Record current position
   - Note 30-day trend (up/down/stable)

2. IDENTIFY opportunities
   - Keywords improving but not top 10
   - Keywords declining from previous position
   - New high-volume keywords in category

3. PRIORITIZE changes
   - Boost: Keywords at position 11-20
   - Maintain: Keywords at position 1-10
   - Replace: Keywords at position 50+ with no improvement

4. IMPLEMENT updates
   - Adjust keyword field (iOS)
   - Update description (Android)
   - Modify subtitle if needed

5. DOCUMENT changes
   - Record what changed and why
   - Set reminder for 2-week check-in

Keyword Testing Log Template

KEYWORD TEST LOG

Test ID: KW-2025-001
Date Started: [Date]
Keywords Changed:
  - Added: "habit tracker" (replacing "goals app")
  - Added: "daily routine" (replacing "schedule planner")

Rationale:
- "habit tracker" has 3x volume of "goals app"
- "daily routine" trending up 40% in category

Baseline Rankings:
- "habit tracker": Not ranked
- "daily routine": Position 87

30-Day Results:
- "habit tracker": Position 34 (+53)
- "daily routine": Position 28 (+59)

Conclusion: Test successful - retain new keywords
Next Action: Target subtitle position for "habit tracker"

---

Supporting file: references/platform-requirements.md

Platform Requirements Reference

Technical specifications and metadata requirements for Apple App Store and Google Play Store.

---

Table of Contents

• Apple App Store Requirements (#apple-app-store-requirements)
• Google Play Store Requirements (#google-play-store-requirements)
• Visual Asset Specifications (#visual-asset-specifications)
• Localization Requirements (#localization-requirements)
• Compliance Guidelines (#compliance-guidelines)

---

Apple App Store Requirements

Metadata Character Limits

Keyword Field Optimization Rules

1. No duplicates - Words in title are already indexed
2. No plurals - Apple indexes both singular and plural forms
3. No spaces after commas - Wastes character space
4. No brand names - Violates App Store guidelines
5. No category names - Already indexed via category selection

Example - Efficient keyword field:

task,todo,checklist,reminder,productivity,organize,schedule,planner,goals,habit

Example - Inefficient keyword field (avoid):

task manager, todo list, productivity app, task tracking

App Store Connect Metadata Fields

Age Rating Content Descriptors

---

Google Play Store Requirements

Metadata Character Limits

Description Keyword Strategy

Google Play has no separate keyword field. Keywords are extracted from:

1. App Title - Highest weight, most important
2. Short Description - High weight, visible in search
3. Full Description - Medium weight, use naturally throughout
4. Developer Name - Low weight but indexed

Keyword Density Guidelines:

• Primary keyword: 2-3% density in full description
• Secondary keywords: 1-2% each
• Avoid keyword stuffing (>5% triggers spam detection)

Google Play Console Metadata

Content Rating (IARC)

---

Visual Asset Specifications

App Icon Requirements

Apple App Store:

Google Play Store:

Screenshot Requirements

Apple App Store:

• Minimum: 2 screenshots per device
• Maximum: 10 screenshots per device
• Format: PNG or JPG, no alpha channel
• First 3 screenshots are critical (most users don't scroll)

Google Play Store:

• Minimum: 2 screenshots
• Maximum: 8 screenshots
• Format: PNG or JPG
• No transparency or borders

App Preview Video

Apple App Store:

• Duration: 15-30 seconds
• Resolution: Match device screenshot size
• Format: M4V, MP4, MOV
• Frame rate: 30 fps
• Audio: Optional but recommended

Google Play Store:

• YouTube video link only
• No duration limit (recommend under 2 minutes)
• Landscape orientation preferred
• Must not contain age-restricted content

---

Localization Requirements

Priority Markets by Revenue

Apple App Store Localization

Supported localizations: 40+ languages

Google Play Store Localization

Supported localizations: 75+ languages

Each locale requires:

• Title (50 chars)
• Short description (80 chars)
• Full description (4,000 chars)
• Screenshots (can reuse or localize)

---

Compliance Guidelines

Apple App Store Review Guidelines Summary

Common Rejection Reasons:

1. Bugs and crashes (50%+ of rejections)
2. Broken links or placeholder content
3. Misleading app descriptions
4. Privacy policy missing or incomplete
5. In-app purchase issues

Google Play Developer Policies

Common Suspension Reasons:

1. Policy violation (content, ads, permissions)
2. Repetitive content (clone apps)
3. Impersonation (fake apps)
4. Intellectual property infringement
5. Malicious behavior

Privacy Requirements

Apple (App Tracking Transparency):

• ATT prompt required for tracking
• Privacy nutrition labels mandatory
• Data collection disclosure required

Google (Data Safety):

• Data safety section mandatory
• Data collection and sharing disclosure
• Security practices declaration

---

Quick Reference Card

Apple vs Google Comparison

---

Supporting file: sample_input.json

{
  "request_type": "keyword_research",
  "app_info": {
    "name": "TaskFlow Pro",
    "category": "Productivity",
    "target_audience": "Professionals aged 25-45 working in teams",
    "key_features": [
      "AI-powered task prioritization",
      "Team collaboration tools",
      "Calendar integration",
      "Cross-platform sync"
    ],
    "unique_value": "AI automatically prioritizes your tasks based on deadlines and importance"
  },
  "target_keywords": [
    "task manager",
    "productivity app",
    "todo list",
    "team collaboration",
    "project management"
  ],
  "competitors": [
    "Todoist",
    "Any.do",
    "Microsoft To Do",
    "Things 3"
  ],
  "platform": "both",
  "language": "en-US"
}