agentleFS
gaznilgaznil/seo-skills-by-gaznil/skills/keyword-research/SKILL.md

keyword-research

Skill0 starsChanged 3 months agoMITView on GitHub

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.

59 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use link-prospecting, seo-project-setup and 8 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • JwuthriSkill

    link-prospecting

    Find link prospects, discover contact paths, and draft outreach from SERPs and backlink signals.

    Also in 11 projects that use this

  • JwuthriSkill

    seo-project-setup

    Set up a durable local SEO workspace with project context, notes, goals, positioning, preferences, MCP checks, and Search Console data intake.

    Also in 11 projects that use this

  • liangdabiaoSkill

    review-analysis

    对亚马逊商品评论进行深度分析,自动识别产品痛点、分析退货原因,生成改进建议和客服回复模板。Invoke when user uses /review-analysis command with a product ASIN.

    Also in 5 projects that use this

  • akii-technologies-ltdSkill

    keyword-clustering

    Cluster and organize keywords into topical groups for SEO. Use when the user asks to "cluster keywords", "group keywords", "organize keywords", "keyword mapping", "topic clusters", "keyword grouping", "build a content plan", "pillar pages", "topical authority", "semantic clustering", or pastes a list of keywords.

    Also in 12 projects that use this

  • opencueSkill

    serp-analysis

    Use when the user asks to "analyze SERPs"; reviews ranking factors, features, intent, AI Overviews, and snippets. SERP分析/搜索结果

    Also in 6 projects that use this

  • +5 more from Jwuthri

The file

We split this skill into the rules it gives an agent

4 rules. 0 are common, 3 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 52 edited versions we read keep these.

  • 3

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Check for project context first: If .claude/project-context.md or .cursor/project-context.md exists, read it for product, audience, and …

    line 16
  2. Distinctive:

    SERP check: Search the term—knowledge cards/Wiki → informational.

    line 81
  3. Distinctive:

    Test if positioning is clear enough for search:

    line 117
  4. Distinctive:

    paid-ads-strategy: When to use paid vs organic.

    line 186

“Common” is measured: kept by at least 6 in 10 of the 52 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

Check for project context first: If .claude/project-context.md or .cursor/project-context.md exists, read it for product, audience, and positioning.

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

MethodPurpose
User perspectiveWhat pain points? What would they search? Customer language from product context
Tool expansionRelated keywords, questions, suggestions; Google autocomplete, PAA, Related Searches
Competitor reverseAnalyze competitor titles, H1, URL; identify topics they rank for; find gaps (#4–10 = opportunity) — see competitor-research
Google PAAPeople Also Ask and Related Searches; high-value signals from real user behavior
Extract from articleWhen 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

IntentContent typeExample
InformationalBlog, guide, FAQ"how to optimize sitemap"
NavigationalBrand page"alignify login"
CommercialComparison, review"SEO tools comparison"
TransactionalProduct, pricing"best SEO tool pricing"

Intent Identification

Modifier words (often signal intent):

IntentModifiers
Informational"how," "what," "why," "guide," "tutorial"
Commercial"best," "compare," "vs," "review," "top"
Transactional"buy," "price," "cheap," "coupon," "free shipping"
LocalLocation 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

MethodUse
SERP overlapKeywords with overlapping top-ranking pages → same cluster
SemanticGroup by meaning, LSI, related concepts
Intent-basedGroup 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

FactorConsider
Search volumeMonthly searches; ~100+/month typical floor; niche can relax
Keyword difficulty (KD)New sites target lower KD
CPCHigher CPC often = stronger commercial intent
SERP featuresFeatured Snippet, PAA, zero-click; SERP features can satisfy intent without click—affects real traffic; see serp-features (Zero-Click section), featured-snippet
Screening order1) 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 flowUse
keyword-research → google-adsKeyword list, clusters, intent; support terms (login, forum, pricing) → negative keywords for PPC
google-ads → keyword-researchPPC conversion rate, Search Terms report → SEO priority; high-converting PPC terms = worth ranking organically
keyword-research → landing-pageClusters → 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

SourceUse
AhrefsKeywords Explorer, Site Explorer
SEMrushKeyword Overview, Organic Research
GSCSearch queries, impressions, clicks
GATraffic by landing page
PostHogFeature/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 project-context.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

SectionContent
Executive SummaryPriorities (top 3)
Keyword OverviewTotal keywords, primary intent, avg KD, content gaps count
Keyword ListKeyword, volume, KD, intent, priority, target page
Keyword MappingPage/URL, target keywords, status
Content GapsKeywords competitors rank for that you don't
Action PlanPriority, action, impact, effort
AppendixSearch intent reference (Informational, Commercial, Transactional, Navigational)

Related Skills

  • 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

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.