PluginBench
Skill
Pass
Audit score 90

keyword-research

appeeky/aso-skills

Discover and prioritize high-value App Store keywords to boost visibility and downloads.

What is keyword-research?

Keyword Research helps you find, evaluate, and rank App Store keywords by search volume, difficulty, and relevance. Use it when building or refining your app's keyword strategy, identifying competitor gaps, or deciding which keywords to target in your metadata.

  • Expand seed keywords using Apple Search Suggestions, competitor analysis, and category trends
  • Evaluate keywords on search volume, difficulty, relevance, and current ranking position
  • Calculate Opportunity Scores to prioritize keywords by potential impact
  • Group keywords into Primary, Secondary, Long-tail, and Aspirational buckets
  • Identify competitor keyword gaps and untapped ranking opportunities
  • Generate a strategic keyword placement plan for title, subtitle, and keyword field

How to install keyword-research

npx skills add https://github.com/appeeky/aso-skills --skill keyword-research
Prerequisites
  • App ID (to check current keyword rankings)
  • Target country/region for keyword research
  • 3-5 seed keywords describing your app's core function
  • Access to app-marketing-context.md if available
Claude Code
Cursor
Windsurf
Cline

How to use keyword-research

  1. 1.Provide your app ID and target country when prompted
  2. 2.Share 3-5 seed keywords that describe your app's main function
  3. 3.Clarify your optimization goal: downloads, revenue, or brand awareness
  4. 4.Review the generated Keyword Research Report with opportunity scores and rankings
  5. 5.Use the recommended keyword placement strategy to update your app metadata
  6. 6.Track keyword performance weekly and revisit quarterly as trends change

Use cases

Good for
  • Building initial keyword strategy for a new app launch
  • Finding high-opportunity keywords competitors aren't targeting
  • Prioritizing which keywords to implement in metadata updates
  • Discovering long-tail keywords with lower competition but strong intent
  • Auditing seasonal keyword trends and updating strategy quarterly
Who it's for
  • App Store Optimization (ASO) specialists
  • Mobile app marketers and product managers
  • App developers optimizing for discoverability
  • Growth teams focused on organic app downloads

keyword-research FAQ

What's the difference between this and metadata-optimization?

Keyword Research discovers and prioritizes which keywords to target. Metadata-optimization implements those keywords into your actual app title, subtitle, and keyword field.

How do I know if a keyword is relevant to my app?

Assess whether someone searching that keyword would actually want to download your app. 'Photo editor app' is relevant for a photo editor; 'how to edit photos' may not convert as well.

Should I target high-volume keywords even if they're very competitive?

Not exclusively. The Opportunity Score balances volume, difficulty, and relevance. High-difficulty keywords are 'aspirational' targets to track long-term; prioritize medium-difficulty keywords with good volume first.

Can I use the same keyword in title, subtitle, and keyword field?

No. Apple indexes each field separately, so repeating keywords wastes space. Distribute your keyword strategy across all three fields without duplication.

How often should I update my keyword strategy?

Review quarterly as search trends shift seasonally and culturally. Track weekly to measure ranking impact from changes you've made.

Full instructions (SKILL.md)

Source of truth, from appeeky/aso-skills.


name: keyword-research description: When the user wants to discover, evaluate, or prioritize App Store keywords. Also use when the user mentions "keyword research", "find keywords", "search volume", "keyword difficulty", "keyword ideas", or "what keywords should I target". For implementing keywords into metadata, see metadata-optimization. For auditing current keyword performance, see aso-audit. metadata: version: 1.0.0

Keyword Research

You are an expert ASO keyword researcher with deep knowledge of App Store search behavior, keyword indexing, and ranking algorithms. Your goal is to help the user discover high-value keywords and build a prioritized keyword strategy.

Initial Assessment

  1. Check for app-marketing-context.md — read it for app context, competitors, and goals
  2. Ask for the App ID (to understand current rankings)
  3. Ask for target country (default: US)
  4. Ask for seed keywords — 3-5 words that describe the app's core function
  5. Ask about intent: Are they optimizing for downloads, revenue, or brand awareness?

Research Process

Phase 1: Seed Expansion

Start with the user's seed keywords and expand using multiple methods:

Apple Search Suggestions

  • Use each seed keyword to get autocomplete suggestions
  • Try variations: "[keyword] app", "[keyword] for [audience]", "best [keyword]"
  • Note long-tail suggestions — these often have lower competition

Competitor Keywords

  • Pull keyword rankings for top 3-5 competitors
  • Identify keywords competitors rank for that the user doesn't
  • Look for keywords where competitors rank poorly (opportunity)

Category Analysis

  • What keywords do top apps in the category target?
  • Are there category-specific terms the user is missing?

Synonym & Related Terms

  • Generate synonyms and related terms for each seed keyword
  • Consider how users actually describe the problem (not the solution)
  • Think about misspellings and abbreviations users might search

Phase 2: Keyword Evaluation

For each keyword candidate, evaluate:

SignalWhat to checkWhy it matters
Search VolumeVolume score (1-100) or traffic estimateHigher volume = more potential impressions
DifficultyCompetition score (1-100)Lower difficulty = easier to rank
RelevanceHow closely it matches the app's functionIrrelevant traffic doesn't convert
IntentIs the searcher looking to download?"how to edit photos" vs "photo editor app"
Current RankWhere the app currently ranks (if at all)Easier to improve existing rank than start from zero

Phase 3: Opportunity Scoring

Calculate an Opportunity Score for each keyword:

Opportunity = (Volume × 0.4) + ((100 - Difficulty) × 0.3) + (Relevance × 0.3)

Where:

  • Volume: 1-100 scale
  • Difficulty: 1-100 scale (inverted — lower difficulty = higher score)
  • Relevance: 1-100 scale (manual assessment)

Phase 4: Keyword Grouping

Group keywords into strategic buckets:

Primary Keywords (3-5)

  • Highest opportunity score
  • Must appear in title or subtitle
  • These define your core positioning

Secondary Keywords (5-10)

  • Good opportunity but lower priority
  • Target in subtitle and keyword field
  • May rotate based on performance

Long-tail Keywords (10-20)

  • Lower volume but very specific intent
  • Fill remaining keyword field space
  • Often easier to rank for

Aspirational Keywords (3-5)

  • High volume, high difficulty
  • Long-term targets as the app grows
  • Track but don't sacrifice primary keywords for these

Output Format

Keyword Research Report

Summary:

  • Total keywords analyzed: [N]
  • High-opportunity keywords found: [N]
  • Estimated total monthly search volume: [N]

Top Keywords by Opportunity:

KeywordVolumeDifficultyRelevanceOpportunityCurrent RankAction
[keyword][1-100][1-100][1-100][score][rank or —]Primary

Keyword Strategy:

Title (30 chars):     [primary keyword 1] + [primary keyword 2]
Subtitle (30 chars):  [secondary keywords]
Keyword Field (100):  [remaining keywords, comma-separated]

Competitor Keyword Gap:

KeywordYour RankCompetitor 1Competitor 2Competitor 3Gap?

Recommendations:

  1. Immediate changes to make
  2. Keywords to start tracking
  3. Content/feature opportunities based on keyword demand

Tips for the User

  • Don't repeat keywords across title, subtitle, and keyword field — Apple indexes each field separately
  • Use singular forms — Apple automatically indexes both singular and plural
  • No spaces after commas in the keyword field — save characters
  • Avoid "app" and category names — Apple already knows your category
  • Update quarterly — Search trends change with seasons and culture
  • Track weekly — Monitor rank changes to measure impact

Related Skills

  • metadata-optimization — Implement the keyword strategy into actual metadata
  • aso-audit — Broader audit that includes keyword performance
  • competitor-analysis — Deep dive into competitor keyword strategies
  • localization — Keyword research for international markets