keyword-research

Installation

$npx skills add irismaker/ai-agent-skills-hub --skill keyword-research

Summary

Equips an agent to discover, validate, and prioritize keywords by search volume, intent, and difficulty, then map them to content structure and identify ranking gaps. Invoke when users want to research keywords, analyze search intent, build topical maps, or find target terms for a product or topic.

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 product marketing context first: If .claude/product-marketing-context.md or .cursor/product-marketing-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

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

  • 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

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)

Related Skills

  • seo-strategy: SEO workflow, Product-Led SEO, audit approach; keyword research is Content phase
  • 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