PluginBench
Skill
Review
Audit score 70

keyword-research

eronred/aso-skills

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

What is keyword-research?

Keyword Research helps you identify, evaluate, and strategically prioritize keywords for App Store optimization. Use it when you need to find new keywords, assess search volume and difficulty, or build a keyword strategy for your app.

  • Expand seed keywords using Apple Search Suggestions, competitor analysis, and category trends
  • Evaluate keywords by search volume, difficulty, relevance, and current ranking position
  • Calculate Opportunity Scores to identify high-potential keywords
  • Group keywords into Primary, Secondary, Long-tail, and Aspirational buckets
  • Generate keyword strategy recommendations for title, subtitle, and keyword field
  • Identify competitor keyword gaps and ranking opportunities

How to install keyword-research

npx skills add https://github.com/eronred/aso-skills --skill keyword-research
Prerequisites
  • App ID (to check current keyword rankings)
  • Target country for keyword research (defaults to US)
  • 3-5 seed keywords describing your app's core function
Claude Code
Cursor
Windsurf
Cline

How to use keyword-research

  1. 1.Provide your app ID and target country
  2. 2.Share 3-5 seed keywords that describe your app's core function
  3. 3.Clarify your optimization goal (downloads, revenue, or brand awareness)
  4. 4.Review the keyword expansion across Apple Search Suggestions, competitors, and category
  5. 5.Evaluate each keyword candidate using the provided signals (volume, difficulty, relevance, intent, current rank)
  6. 6.Use the Opportunity Score formula to rank keywords
  7. 7.Group keywords into Primary, Secondary, Long-tail, and Aspirational categories
  8. 8.Implement top keywords into your metadata using metadata-optimization skill

Use cases

Good for
  • Launching a new app and need to identify 30-50 target keywords
  • Improving rankings for an existing app by finding underexploited keywords
  • Analyzing competitor keyword strategies to find gaps in your coverage
  • Building a quarterly keyword refresh plan based on search trends
  • Prioritizing which keywords to target first based on opportunity scores
Who it's for
  • App Store Optimization (ASO) specialists
  • Mobile app product managers
  • App marketing managers
  • App developers planning launch strategy

keyword-research FAQ

What's the difference between keyword research and metadata optimization?

Keyword Research discovers and prioritizes which keywords to target. Metadata Optimization implements those keywords into your app's title, subtitle, and keyword field. Use this skill first, then metadata-optimization to apply the results.

How often should I do keyword research?

Update quarterly to catch seasonal trends and cultural shifts. Track weekly to monitor rank changes and measure the impact of your keyword changes.

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

High-volume, high-difficulty keywords are best treated as long-term aspirational targets. Focus first on Primary and Secondary keywords with better opportunity scores, then track aspirational keywords as your app grows.

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

No. Apple indexes each field separately, so repeating keywords wastes valuable space. Distribute your keywords across fields to maximize coverage.

What if my app doesn't rank for any of my target keywords yet?

Start with Secondary and Long-tail keywords where you have a better chance to rank quickly. As you gain visibility, you can compete for Primary and Aspirational keywords.

Full instructions (SKILL.md)

Source of truth, from eronred/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