Keyword research skill

When the user wants to research keywords, find target keywords, or analyze search intent.

by kostja94·MIT license·★ 1,006 Stars on the repo·GitHub ↗

Use now

Files of Keyword research

kostja94/main1 file shown
SKILL.md
Show the full text196 lines

SEO Content: Keyword Research

Guides keyword research for SEO: finding target keywords, assessing difficulty, understanding search intent, and building topical maps. ~95% of keywords get fewer than 10 searches/month; low-volume, high-intent terms often yield faster rankings and conversion.

When invoking: On first use, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.

Initial Assessment

Project context: Read root contextus.md when present and load only the modules relevant to this task. Without Contextus, use available project material or user-provided facts and ask for missing information; do not create a parallel context system.

Identify:

  1. Product/service: What you offer
  2. Audience: Who searches for it
  3. Goals: Traffic, conversions, brand
  4. Tool access: Google Keyword Planner, Google Trends, or SEO tools

Discovery Methods

Base Discovery
Method Purpose
User perspective What pain points? What would they search? Customer language from product context
Tool expansion Related keywords, questions, suggestions; Google autocomplete, PAA, Related Searches
Competitor reverse Analyze competitor titles, H1, URL; identify topics they rank for; find gaps (#4–10 = opportunity) — see competitor-research
Google PAA People Also Ask and Related Searches; high-value signals from real user behavior
Extract from article When auditing existing content: extract seed keywords from title, H1, H2s, meta keywords, first 100 words; then search "[primary keyword]" or "[primary keyword] related keywords" for opportunities; use "[primary keyword]" site:competitor.com if competitors known
Google Autocomplete (Long-Tail Discovery)

Google autocomplete reflects real user searches; suggestions only appear if queries have actual traffic. Free; often uncovers low-volume long-tail that keyword tools miss. ~70% of search traffic is long-tail; lower competition, higher conversion.

Alphabet method (seed + space + letter):

  • Type seed keyword + space + each letter: keyword a, keyword b, ... keyword z
  • Record relevant suggestions; repeat with numbers 0-9
  • Example: SEO a -> "SEO audit," "SEO agency"; SEO b -> "SEO basics," "SEO best practices"

Position variants (seed in different positions):

  • Prefix: a keyword, b keyword (discover what users add before)
  • Suffix: keyword a, keyword b (most common; alphabet method)
  • Middle: how to keyword a, best keyword for (question + modifier combos)

Question modifiers:

  • how to keyword, what is keyword, why keyword, when to keyword, keyword vs
  • keyword for beginners, keyword for small business, keyword without

Why it works: Keyword tools filter low-volume terms; autocomplete only shows queries with real traffic. Use with PAA and Related Searches for full coverage. Categorize results by intent (informational, commercial, transactional).

Incremental Discovery
  • User feedback: Support, community, reviews, NPS—high-frequency questions = unmet search demand
  • Multi-platform search: Reddit, Quora, X (Twitter), Hacker News—real questions and discussions

Search Intent

Intent Content type Example
Informational Blog, guide, FAQ "how to optimize sitemap"
Navigational Brand page "alignify login"
Commercial Comparison, review "SEO tools comparison"
Transactional Product, pricing "best SEO tool pricing"
Intent Identification

Modifier words (often signal intent):

Intent Modifiers
Informational "how," "what," "why," "guide," "tutorial"
Commercial "best," "compare," "vs," "review," "top"
Transactional "buy," "price," "cheap," "coupon," "free shipping"
Local Location names

SERP check: Search the term—knowledge cards/Wiki → informational; product lists/reviews → commercial; brand sites → navigational. Broader terms often show mixed SERP. See serp-features for feature types.

Long-Tail Expansion

  • Google Autocomplete: Alphabet method, position variants, question modifiers; see above. Primary source for long-tail.
  • Intent modifiers: Core + "how," "best," "vs," "compare," "price"
  • Question words: "how to," "what is," "why," "when"
  • Functional modifiers: Core + "-er/-or" (e.g., "image optimizer" for tool-type queries); often higher conversion
  • Clustering: Group by SERP overlap (same top pages), semantic similarity, or intent.

Keyword Clustering & Topical Map

Method Use
SERP overlap Keywords with overlapping top-ranking pages → same cluster
Semantic Group by meaning, LSI, related concepts
Intent-based Group by intent; separate pages if intent differs within cluster

Pillar–cluster (map keywords to structure):

  • Pillar (Hub): Broad topic page; links to clusters
  • Cluster (Spoke): Focused subtopic; links back to pillar
  • Target long-tail first; then pillar. Interlink clusters within topic.
  • See content-strategy for full pillar-cluster planning and implementation.

Evaluate & Screen

Factor Consider
Search volume Monthly searches; ~100+/month typical floor; niche can relax
Keyword difficulty (KD) New sites target lower KD
CPC Higher CPC often = stronger commercial intent
SERP features Featured Snippet, PAA, zero-click; SERP features can satisfy intent without click—affects real traffic; see serp-features (Zero-Click section), featured-snippet
Screening order 1) Remove irrelevant 2) Filter very low volume 3) Assess achievability 4) Prioritize commercial/transactional

Product Positioning Test (SEO Fit)

Test if positioning is clear enough for search:

  • XXX + Function words: Generator, Creator, Maker, Builder, Changer, Shortener, Scraper, Converter, Downloader, Translator, Extender, Summarizer, Resizer, Remover, Extractor, Recorder, Rewriter, Solver, Calculator; or Platform, Tool, Software, App, Provider, Assistant, Copilot
  • Input + to + Output: e.g., "image to video," "text to speech"—clear input/output signals intent

Agent/Copilot products: Pure native Agent hard to grow via SEO; users rarely search "agent." Release related features first (e.g., CRM, sales bot for sales agent) to build traffic, then funnel to Agent product.

Principles

  • Core rule: Someone must search it—validate with tools; avoid inventing terms
  • Functional keywords: Tool-type (-er/-or) often convert better; users are closer to action
  • Multi-language: Re-research in target language; don't translate existing lists. See translation for translation workflow.

SEO–PPC Keyword Synergy

Keyword research serves both SEO and Google Ads. Align both channels to avoid duplication, cannibalization, and wasted spend.

Data flow Use
keyword-research → google-ads Keyword list, clusters, intent; support terms (login, forum, pricing) → negative keywords for PPC
google-ads → keyword-research PPC conversion rate, Search Terms report → SEO priority; high-converting PPC terms = worth ranking organically
keyword-research → landing-page Clusters → dedicated LP per intent; PAA questions → FAQ sections
GSC organic rank 4+ If you rank well organically, consider reducing/pausing PPC on those terms to avoid cannibalization

PPC data for SEO priority: SEO ROI ≈ (Organic clicks × PPC conversion rate × Customer value) − SEO cost. Use PPC conversion data to validate which keywords to pursue in organic.

Reference: Backlinko – SEO and PPC: 8 Smart Ways to Align

Data Sources

Source Use
Ahrefs Keywords Explorer, Site Explorer
SEMrush Keyword Overview, Organic Research
GSC Search queries, impressions, clicks
GA Traffic by landing page
PostHog Feature/search usage

Report Workflow

  1. Parse — Read Excel/CSV, infer keyword, volume, KD, intent, etc. from headers
  2. Enrich — Web search, visit competitor/product pages; read root contextus.md if present
  3. Build — Structure data for report
  4. Generate — Output report in chosen format

Output Format

  • Keyword list with volume, KD, intent
  • Keyword mapping to pages/content
  • Content gaps (competitors rank, you don't)
  • Priority ranking for implementation
  • Topical map (cluster → pillar → page mapping)
Report Structure Reference
Section Content
Executive Summary Priorities (top 3)
Keyword Overview Total keywords, primary intent, avg KD, content gaps count
Keyword List Keyword, volume, KD, intent, priority, target page
Keyword Mapping Page/URL, target keywords, status
Content Gaps Keywords competitors rank for that you don't
Action Plan Priority, action, impact, effort
Appendix Search intent reference (Informational, Commercial, Transactional, Navigational)
  • seo-strategy: SEO workflow, Product-Led SEO, audit approach; keyword research is Content phase
  • google-ads: Keywords inform Search targeting; PPC data feeds back into SEO priority
  • paid-ads-strategy: When to use paid vs organic; channel selection
  • content-strategy: Keywords inform content plan; topic clusters
  • content-optimization: Keyword placement, density vs stuffing, H2 keywords
  • title-tag, meta-description: Keywords in title, description
  • heading-structure: Keywords in H1, H2
  • link-building: Keywords inform link targets
  • serp-features: SERP features in keyword screening; PAA, Featured Snippet
  • featured-snippet: Snippet-worthy query targeting
  • competitor-research: Competitor keyword/topic analysis; reverse engineering
  • faq-page-generator: PAA questions to FAQ sections; question-based keyword to FAQ content
1---
2name: keyword-research
3description: When the user wants to research keywords, find target keywords, or analyze search intent. Also use when the user mentions "keyword research," "keyword tool," "target keywords," "search volume," "search intent," "keyword difficulty," "topical map," "keyword clustering," "People Also Ask," "Google autocomplete," "autocomplete keywords," or "alphabet method." For clusters, use content-strategy.
4metadata:
5 version: 1.3.1
6---
7 
8# SEO Content: Keyword Research
9 
10Guides keyword research for SEO: finding target keywords, assessing difficulty, understanding search intent, and building topical maps. ~95% of keywords get fewer than 10 searches/month; low-volume, high-intent terms often yield faster rankings and conversion.
11 
12**When invoking**: On **first use**, if helpful, open with 1–2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output.
13 
14## Initial Assessment
15 
16**Project context:** Read root `contextus.md` when present and load only the modules relevant to this task. Without Contextus, use available project material or user-provided facts and ask for missing information; do not create a parallel context system.
17 
18Identify:
191. **Product/service**: What you offer
202. **Audience**: Who searches for it
213. **Goals**: Traffic, conversions, brand
224. **Tool access**: Google Keyword Planner, Google Trends, or SEO tools
23 
24## Discovery Methods
25 
26### Base Discovery
27 
28| Method | Purpose |
29|--------|---------|
30| **User perspective** | What pain points? What would they search? Customer language from product context |
31| **Tool expansion** | Related keywords, questions, suggestions; Google autocomplete, PAA, Related Searches |
32| **Competitor reverse** | Analyze competitor titles, H1, URL; identify topics they rank for; find gaps (#4–10 = opportunity) — see **competitor-research** |
33| **Google PAA** | People Also Ask and Related Searches; high-value signals from real user behavior |
34| **Extract from article** | When auditing existing content: extract seed keywords from title, H1, H2s, meta keywords, first 100 words; then search `"[primary keyword]"` or `"[primary keyword] related keywords"` for opportunities; use `"[primary keyword]" site:competitor.com` if competitors known |
35 
36### Google Autocomplete (Long-Tail Discovery)
37 
38Google autocomplete reflects real user searches; suggestions only appear if queries have actual traffic. Free; often uncovers low-volume long-tail that keyword tools miss. ~70% of search traffic is long-tail; lower competition, higher conversion.
39 
40**Alphabet method** (seed + space + letter):
41- Type seed keyword + space + each letter: `keyword a`, `keyword b`, ... `keyword z`
42- Record relevant suggestions; repeat with numbers 0-9
43- Example: `SEO a` -> "SEO audit," "SEO agency"; `SEO b` -> "SEO basics," "SEO best practices"
44 
45**Position variants** (seed in different positions):
46- **Prefix**: `a keyword`, `b keyword` (discover what users add before)
47- **Suffix**: `keyword a`, `keyword b` (most common; alphabet method)
48- **Middle**: `how to keyword a`, `best keyword for` (question + modifier combos)
49 
50**Question modifiers**:
51- `how to keyword`, `what is keyword`, `why keyword`, `when to keyword`, `keyword vs`
52- `keyword for beginners`, `keyword for small business`, `keyword without`
53 
54**Why it works**: Keyword tools filter low-volume terms; autocomplete only shows queries with real traffic. Use with PAA and Related Searches for full coverage. Categorize results by intent (informational, commercial, transactional).
55 
56### Incremental Discovery
57 
58- **User feedback**: Support, community, reviews, NPS—high-frequency questions = unmet search demand
59- **Multi-platform search**: Reddit, Quora, X (Twitter), Hacker News—real questions and discussions
60 
61## Search Intent
62 
63| Intent | Content type | Example |
64|--------|--------------|---------|
65| **Informational** | Blog, guide, FAQ | "how to optimize sitemap" |
66| **Navigational** | Brand page | "alignify login" |
67| **Commercial** | Comparison, review | "SEO tools comparison" |
68| **Transactional** | Product, pricing | "best SEO tool pricing" |
69 
70### Intent Identification
71 
72**Modifier words** (often signal intent):
73 
74| Intent | Modifiers |
75|--------|-----------|
76| Informational | "how," "what," "why," "guide," "tutorial" |
77| Commercial | "best," "compare," "vs," "review," "top" |
78| Transactional | "buy," "price," "cheap," "coupon," "free shipping" |
79| Local | Location names |
80 
81**SERP check**: Search the term—knowledge cards/Wiki → informational; product lists/reviews → commercial; brand sites → navigational. Broader terms often show mixed SERP. See **serp-features** for feature types.
82 
83## Long-Tail Expansion
84 
85- **Google Autocomplete**: Alphabet method, position variants, question modifiers; see above. Primary source for long-tail.
86- **Intent modifiers**: Core + "how," "best," "vs," "compare," "price"
87- **Question words**: "how to," "what is," "why," "when"
88- **Functional modifiers**: Core + "-er/-or" (e.g., "image optimizer" for tool-type queries); often higher conversion
89- **Clustering**: Group by SERP overlap (same top pages), semantic similarity, or intent.
90 
91## Keyword Clustering & Topical Map
92 
93| Method | Use |
94|--------|-----|
95| **SERP overlap** | Keywords with overlapping top-ranking pages → same cluster |
96| **Semantic** | Group by meaning, LSI, related concepts |
97| **Intent-based** | Group by intent; separate pages if intent differs within cluster |
98 
99**Pillar–cluster** (map keywords to structure):
100- **Pillar** (Hub): Broad topic page; links to clusters
101- **Cluster** (Spoke): Focused subtopic; links back to pillar
102- Target long-tail first; then pillar. Interlink clusters within topic.
103- See **content-strategy** for full pillar-cluster planning and implementation.
104 
105## Evaluate & Screen
106 
107| Factor | Consider |
108|--------|----------|
109| **Search volume** | Monthly searches; ~100+/month typical floor; niche can relax |
110| **Keyword difficulty (KD)** | New sites target lower KD |
111| **CPC** | Higher CPC often = stronger commercial intent |
112| **SERP features** | Featured Snippet, PAA, zero-click; SERP features can satisfy intent without click—affects real traffic; see **serp-features** (Zero-Click section), **featured-snippet** |
113| **Screening order** | 1) Remove irrelevant 2) Filter very low volume 3) Assess achievability 4) Prioritize commercial/transactional |
114 
115## Product Positioning Test (SEO Fit)
116 
117Test if positioning is clear enough for search:
118 
119- **XXX + Function words**: Generator, Creator, Maker, Builder, Changer, Shortener, Scraper, Converter, Downloader, Translator, Extender, Summarizer, Resizer, Remover, Extractor, Recorder, Rewriter, Solver, Calculator; or Platform, Tool, Software, App, Provider, Assistant, Copilot
120- **Input + to + Output**: e.g., "image to video," "text to speech"—clear input/output signals intent
121 
122**Agent/Copilot products**: Pure native Agent hard to grow via SEO; users rarely search "agent." Release related features first (e.g., CRM, sales bot for sales agent) to build traffic, then funnel to Agent product.
123 
124## Principles
125 
126- **Core rule**: Someone must search it—validate with tools; avoid inventing terms
127- **Functional keywords**: Tool-type (-er/-or) often convert better; users are closer to action
128- **Multi-language**: Re-research in target language; don't translate existing lists. See **translation** for translation workflow.
129 
130## SEO–PPC Keyword Synergy
131 
132Keyword research serves both SEO and Google Ads. Align both channels to avoid duplication, cannibalization, and wasted spend.
133 
134| Data flow | Use |
135|-----------|-----|
136| **keyword-research → google-ads** | Keyword list, clusters, intent; support terms (login, forum, pricing) → negative keywords for PPC |
137| **google-ads → keyword-research** | PPC conversion rate, Search Terms report → SEO priority; high-converting PPC terms = worth ranking organically |
138| **keyword-research → landing-page** | Clusters → dedicated LP per intent; PAA questions → FAQ sections |
139| **GSC organic rank 4+** | If you rank well organically, consider reducing/pausing PPC on those terms to avoid cannibalization |
140 
141**PPC data for SEO priority**: `SEO ROI ≈ (Organic clicks × PPC conversion rate × Customer value) − SEO cost`. Use PPC conversion data to validate which keywords to pursue in organic.
142 
143**Reference**: [Backlinko – SEO and PPC: 8 Smart Ways to Align](https://backlinko.com/seo-and-ppc)
144 
145## Data Sources
146 
147| Source | Use |
148|--------|-----|
149| **Ahrefs** | Keywords Explorer, Site Explorer |
150| **SEMrush** | Keyword Overview, Organic Research |
151| **GSC** | Search queries, impressions, clicks |
152| **GA** | Traffic by landing page |
153| **PostHog** | Feature/search usage |
154 
155## Report Workflow
156 
1571. **Parse** — Read Excel/CSV, infer keyword, volume, KD, intent, etc. from headers
1582. **Enrich** — Web search, visit competitor/product pages; read root `contextus.md` if present
1593. **Build** — Structure data for report
1604. **Generate** — Output report in chosen format
161 
162## Output Format
163 
164- **Keyword list** with volume, KD, intent
165- **Keyword mapping** to pages/content
166- **Content gaps** (competitors rank, you don't)
167- **Priority** ranking for implementation
168- **Topical map** (cluster → pillar → page mapping)
169 
170### Report Structure Reference
171 
172| Section | Content |
173|---------|---------|
174| Executive Summary | Priorities (top 3) |
175| Keyword Overview | Total keywords, primary intent, avg KD, content gaps count |
176| Keyword List | Keyword, volume, KD, intent, priority, target page |
177| Keyword Mapping | Page/URL, target keywords, status |
178| Content Gaps | Keywords competitors rank for that you don't |
179| Action Plan | Priority, action, impact, effort |
180| Appendix | Search intent reference (Informational, Commercial, Transactional, Navigational) |
181 
182## Related Skills
183 
184- **seo-strategy**: SEO workflow, Product-Led SEO, audit approach; keyword research is Content phase
185- **google-ads**: Keywords inform Search targeting; PPC data feeds back into SEO priority
186- **paid-ads-strategy**: When to use paid vs organic; channel selection
187- **content-strategy**: Keywords inform content plan; topic clusters
188- **content-optimization**: Keyword placement, density vs stuffing, H2 keywords
189- **title-tag, meta-description**: Keywords in title, description
190- **heading-structure**: Keywords in H1, H2
191- **link-building**: Keywords inform link targets
192- **serp-features**: SERP features in keyword screening; PAA, Featured Snippet
193- **featured-snippet**: Snippet-worthy query targeting
194- **competitor-research**: Competitor keyword/topic analysis; reverse engineering
195- **faq-page-generator**: PAA questions to FAQ sections; question-based keyword to FAQ content
196 

Discussion

Alternatives

Agentic Browsing ReadinessAudit and fix agent readiness: the Lighthouse Agentic Browsing fraction, accessibility tree for agents, robots.txt and Content-Signal for AI agents, WAF treatment of agent traffic, llms.txt, Markdown delivery, ai-catalog.json, /.well-known discovery files, and WebMCP tools. Exclude AI citability and brand signals (seo-geo) and commerce protocol depth (seo-ecommerce).Marketing · MITBacklink Profile AnalysisBacklink profile analysis: referring domains, anchor text distribution, toxic link detection, competitor gap analysis. Works with free APIs (Moz, Bing Webmaster, Common Crawl) and DataForSEO extension. Use when user says backlinks, link profile, referring domains, anchor text, toxic links, link gap, link building, disavow, or backlink audit.Marketing · MIT/setup-cmsConnect a CMS to notfair SEO tools. Guides users through configuring WordPress, Strapi, Contentful, or Ghost — tests the connection, and writes credentials to .env.local. Once set up, seo-analysis automatically cross- references CMS content against Google Search Console data. Use whenever the user says "connect my CMS", "set up WordPress", "configure Strapi", "add Contentful", "connect Ghost", or "CMS setup". Also trigger if the user asks why no CMS data appears in a seo-analysis report. · MITBacklink checkBacklink profile for any domain — referring domains, authority, anchors, new/lost links, and a side-by-side vs a competitor. Use when asked "check my backlinks", "backlink profile of X", "who links to them", or "link gap vs competitor".Marketing · MIT