
Keyword Research
Discover and prioritize App Store search terms before you rewrite title, subtitle, and keyword field metadata.
Overview
Keyword Research is an agent skill for the Launch phase that discovers, scores, and prioritizes App Store search keywords for a target country before metadata changes.
Install
npx skills add https://github.com/eronred/aso-skills --skill keyword-researchWhat is this skill?
- Runs an initial assessment: app context file, App ID, country, seed keywords, and download vs revenue vs brand intent
- Phase 1 seed expansion via Apple Search autocomplete, long-tail variants, and top competitor keyword pulls
- Explicit handoffs to metadata-optimization for implementation and aso-audit for performance review
- Defaults to US locale but supports per-market keyword strategy
- Frames decisions around App Store search behavior, indexing, and ranking algorithms
- Phase 1 seed expansion workflow
- Initial assessment asks for 3–5 seed keywords
Adoption & trust: 1.7k installs on skills.sh; 1.5k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You know your app’s purpose but not which App Store search terms are worth targeting or how crowded each phrase is.
Who is it for?
Indie iOS builders preparing a listing refresh, localizing keywords, or entering a category where competitor terms are unknown.
Skip if: Teams that only need on-page web SEO, already have a locked keyword map with performance data, or want metadata copy written without research (use metadata-optimization instead).
When should I use this skill?
User wants to discover, evaluate, or prioritize App Store keywords; mentions keyword research, search volume, keyword difficulty, keyword ideas, or what keywords to target.
What do I get? / Deliverables
You leave with an expanded, prioritized keyword strategy grounded in seeds, autocomplete, and competitor signals—ready to hand off to metadata-optimization or validate with aso-audit.
- Prioritized keyword list aligned to downloads, revenue, or brand intent
- Expanded seed set from autocomplete and competitor signals
- Research notes suitable for metadata-optimization input
Recommended Skills
Journey fit
Keyword research is the upstream ASO step that feeds metadata and audit workflows in the launch phase. ASO subphase is where solo indie devs choose which terms to target per country before shipping store listing changes.
How it compares
Research-first ASO workflow, not a one-shot metadata rewrite or MCP data connector.
Common Questions / FAQ
Who is keyword-research for?
Solo and indie mobile developers, small app teams, and agent-assisted marketers who ship or maintain App Store listings and need structured keyword discovery without an ASO agency.
When should I use keyword-research?
Use it in Launch (ASO) when planning a new app’s store positioning, before a major metadata update, when entering a new country, or when autocomplete and competitor terms need a fresh pass—especially prior to metadata-optimization or after disappointing rankings that aso-audit mi
Is keyword-research safe to install?
Treat it like any third-party agent skill: review the Security Audits panel on this Prism page, confirm the repo source, and avoid pasting credentials into chats; the skill describes research steps rather than requiring secret keys by default.
Workflow Chain
Then invoke: metadata optimization, aso audit
SKILL.md
READMESKILL.md - Keyword Research
# 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] |