Keyword Research

SEO & GEO Skills Library · 20 skills for SEO + GEO · ClawHub · skills.sh
System Mode: This research skill follows the shared Skill Contract and State Model.

Discovers, analyzes, and prioritizes keywords for SEO and GEO content strategies. Identifies high-value opportunities based on search volume, competition, intent, and business relevance.

System role: Research layer skill. It turns market signals into reusable strategic inputs for the rest of the library.

When This Must Trigger

Use this when the conversation involves reusable market intelligence that should influence strategy — even if the user doesn't use SEO terminology:

• Starting a new content strategy or campaign
• Expanding into new topics or markets
• Finding keywords for a specific product or service
• Identifying long-tail keyword opportunities
• Understanding search intent for your industry
• Planning content calendars
• Researching keywords for GEO optimization

What This Skill Does

1. Keyword Discovery: Generates comprehensive keyword lists from seed terms
2. Intent Classification: Categorizes keywords by user intent (informational, navigational, commercial, transactional)
3. Difficulty Assessment: Evaluates competition level and ranking difficulty
4. Opportunity Scoring: Prioritizes keywords by potential ROI
5. Clustering: Groups related keywords into topic clusters
6. GEO Relevance: Identifies keywords likely to trigger AI responses

Quick Start

Start with one of these prompts. Finish with a short handoff summary using the repository format in Skill Contract.

Basic Keyword Research

Research keywords for [topic/product/service]

Find keyword opportunities for a [industry] business targeting [audience]

With Specific Goals

Find low-competition keywords for [topic] with commercial intent

Identify question-based keywords for [topic] that AI systems might answer

Competitive Research

What keywords is [competitor URL] ranking for that I should target?

Skill Contract

Expected output: a prioritized research brief, evidence-backed findings, and a short handoff summary ready for memory/research/.

• Reads: user goals, target market inputs, available tool data, and prior strategy from CLAUDE.md and the shared State Model when available.
• Writes: a user-facing research deliverable plus a reusable summary that can be stored under memory/research/.
• Promotes: durable keyword priorities, competitor facts, entity candidates, and strategic decisions to memory/hot-cache.md, memory/decisions.md, and memory/research/; hand canonical entity work to entity-optimizer.
• Next handoff: use the Next Best Skill below when the findings are ready to drive action.

Handoff Summary

Emit this shape when finishing the skill (see skill-contract.md §Handoff Summary Format for the authoritative format):

• Status: DONE / DONE_WITH_CONCERNS / BLOCKED / NEEDS_INPUT
• Objective: what was analyzed, created, or fixed
• Key Findings / Output: the highest-signal result
• Evidence: URLs, data points, or sections reviewed
• Open Loops: blockers, missing inputs, or unresolved risks
• Recommended Next Skill: one primary next move

Data Sources

Note: All integrations are optional. This skill works without any API keys — users provide data manually when no tools are connected.

See CONNECTORS.md for tool category placeholders.

With ~~SEO tool + ~~search console connected:
Automatically pull historical search volume data, keyword difficulty scores, SERP analysis, current rankings from ~~search console, and competitor keyword overlap. The skill will fetch seed keyword metrics, related keyword suggestions, and search trend data.

With manual data only:
Ask the user to provide:

1. Seed keywords or topic description
2. Target audience and geographic location
3. Business goals (traffic, leads, sales)
4. Current domain authority (if known) or site age
5. Any known keyword performance data or search volume estimates

Proceed with the full analysis using provided data. Note in the output which metrics are from automated collection vs. user-provided data.

Instructions

When a user requests keyword research, run eight phases (announce each as [Phase X/8: Name]):

1. Scope — clarify product, audience, business goal, DR, geography, language
2. Discover — seed from core/problem/solution/audience/industry terms
3. Variations — expand with modifier and long-tail patterns
4. Classify — tag each by intent (informational/navigational/commercial/transactional)
5. Score — assign difficulty (1-100) and compute Opportunity = (Volume × Intent Value) / Difficulty with Intent Value 1/1/2/3
6. GEO-Check — flag AI-answer-friendly queries (questions, definitions, comparisons, lists, how-tos)
7. Cluster — group keywords into pillar + cluster topic hubs
8. Deliver — Executive Summary, Quick Wins / Growth / GEO opportunities, Topic Clusters, Content Calendar, Next Steps

Quality bar — every recommendation must include at least one specific number. Generic advice like "target long-tail keywords for better results" must be rewritten as "Target 'project management for nonprofits' (vol: 320, KD: 22) — no DR>40 sites in top 10" before including.

Reference: See references/instructions-detail.md for the full 8-phase templates, expansion patterns, intent classification table, difficulty tiers, opportunity matrix, GEO indicators, cluster template, deliverable quality bar with actionable vs. generic examples, and tips.

Validation Checkpoints

Input Validation

• Seed keywords or topic description clearly provided
• Target audience and business goals specified
• Geographic and language targeting confirmed
• Domain authority or site maturity level established

Output Validation

• Every recommendation cites specific data points (not generic advice)
• Search volume and difficulty scores included for each keyword
• Keywords grouped by intent and mapped to content types
• Topic clusters show clear pillar-to-cluster relationships
• Source of each data point clearly stated (~~SEO tool data, user-provided, or estimated)

Example

User: "Research keywords for a project management software company targeting small businesses"

Output (abbreviated): 150+ keywords analyzed, 23 high-priority opportunities with ~45K/month traffic potential across 3 focus areas (task management workflows, team collaboration, small business productivity). Quick Wins prioritized by KD × volume × intent fit.

Reference: See references/example-report.md for the full report for "project management software for small businesses".

Advanced Usage

Intent Mapping, Seasonal Analysis, Competitor Gap, Local Keywords — see references/instructions-detail.md.

Tips for Success

Start with seeds; don't ignore long-tail; match intent; cluster for topical authority; prioritize quick wins; include GEO keywords; review quarterly. See references/instructions-detail.md.

Save Results

After delivering findings to the user, ask:

"Save these results for future sessions?"

If yes, write a dated summary to memory/research/keyword-research/YYYY-MM-DD-<topic>.md containing:

• One-line headline finding
• Top 3-5 actionable items
• Open loops or blockers
• Source data references

If any findings should influence ongoing strategy, recommend promoting key conclusions to memory/hot-cache.md.

Reference Materials

• Instructions Detail — Full 8-phase workflow, expansion patterns, scoring, cluster templates, advanced usage, tips
• Keyword Intent Taxonomy — Complete intent classification with signal words and content strategies
• Topic Cluster Templates — Hub-and-spoke architecture templates for pillar and cluster content
• Keyword Prioritization Framework — Priority scoring matrix, categories, and seasonal keyword patterns
• Example Report — Complete example keyword research report for project management software

Next Best Skill

• Primary: competitor-analysis — turn keyword opportunities into a competitive benchmark.
• Also consider (pick by goal):
  • content-gap-analysis — if competitors are already known and the goal is producing content fast.
  • serp-analysis — if SERP features (featured snippets, PAA, AI Overviews) must be understood before writing.