
Keyword Research
- 2.6k installs
- 1.7k repo stars
- Updated July 27, 2026
- eronred/aso-skills
keyword-research is an ASO skill for discovering, scoring, and prioritizing App Store keywords from seeds and competitor data.
About
The keyword-research skill guides App Store keyword discovery, evaluation, and prioritization for download, revenue, or brand awareness goals. Initial assessment reads app-marketing-context.md when present, then collects App ID, target country, three to five seed keywords, and optimization intent. Phase one expands seeds via Apple Search Suggestions autocomplete, competitor keyword rankings for top rivals, category leader terms, and synonym or problem-language variants including common misspellings. Phase two scores candidates on relevance, search volume bands, difficulty, current ranking position, and strategic fit, then buckets keywords into primary, secondary, and long-tail targets. Deliverables include a prioritized keyword table, competitor gap list, and implementation notes pointing to metadata-optimization for placement and aso-audit for performance review. The skill explicitly defers metadata implementation and ranking audits to sibling ASO skills while focusing on research methodology and prioritization discipline.
- Starts from app-marketing-context.md, App ID, country, seeds, and intent.
- Expands seeds via Apple suggestions, competitors, category leaders, and synonyms.
- Scores relevance, volume, difficulty, rank, and strategic fit per keyword.
- Outputs primary, secondary, and long-tail buckets with competitor gaps.
- Pairs with metadata-optimization and aso-audit for implementation and tracking.
Keyword Research by the numbers
- 2,647 all-time installs (skills.sh)
- +83 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #226 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
keyword-research capabilities & compatibility
- Capabilities
- seed expansion via apple search suggestions and · competitor keyword ranking gap analysis · category and synonym term discovery · keyword scoring and primary or long tail bucketi · handoff guidance to metadata optimization and as
- Use cases
- seo · marketing · research
What keyword-research says it does
Your goal is to help the user discover high-value keywords and build a prioritized keyword strategy.
For implementing keywords into metadata, see metadata-optimization.
npx skills add https://github.com/eronred/aso-skills --skill keyword-researchAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 2.6k |
|---|---|
| repo stars | ★ 1.7k |
| Security audit | 2 / 3 scanners passed |
| Last updated | July 27, 2026 |
| Repository | eronred/aso-skills ↗ |
What keywords should I target on the App Store for my app in a given country?
Discover, evaluate, and prioritize App Store keywords using seed expansion, competitor analysis, and scoring for an ASO strategy.
Who is it for?
Mobile apps needing structured App Store keyword research before metadata updates.
Skip if: Skip for writing store metadata or auditing current keyword performance; use sibling ASO skills.
When should I use this skill?
User mentions keyword research, search volume, keyword difficulty, or what keywords to target.
What you get
A prioritized keyword strategy with volume, difficulty, and competitor gap notes ready for metadata work.
- Prioritized keyword list
- Difficulty and volume assessments
By the numbers
- Skill version 1.0.0 in aso-skills metadata
Files
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:
| Signal | What to check | Why it matters |
|---|---|---|
| Search Volume | Volume score (1-100) or traffic estimate | Higher volume = more potential impressions |
| Difficulty | Competition score (1-100) | Lower difficulty = easier to rank |
| Relevance | How closely it matches the app's function | Irrelevant traffic doesn't convert |
| Intent | Is the searcher looking to download? | "how to edit photos" vs "photo editor app" |
| Current Rank | Where 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:
| Keyword | Volume | Difficulty | Relevance | Opportunity | Current Rank | Action |
|---|---|---|---|---|---|---|
| [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:
| Keyword | Your Rank | Competitor 1 | Competitor 2 | Competitor 3 | Gap? |
|---|
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 metadataaso-audit— Broader audit that includes keyword performancecompetitor-analysis— Deep dive into competitor keyword strategieslocalization— Keyword research for international markets
Related skills
FAQ
What inputs does the skill need first?
App ID, target country, three to five seed keywords, and whether you optimize for downloads, revenue, or awareness.
Does it write App Store metadata?
No. It researches and prioritizes keywords; use metadata-optimization to implement them.
How are competitors used?
Pull rankings for top rivals to find gaps where they rank and you do not, or where they rank poorly.
Is Keyword Research safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.