Skip to content

WesleySmits/agent-skills / .agent/skills/seo-keyword-research

researching-seo-keywords

Verified

Expands keyword lists and analyzes search intent for content strategy. Use when the user asks about keyword research, search intent, long-tail keywords, keyword gaps, or SEO content planning.

SEO Keyword Research Assistant

When to use this skill

  • User asks for keyword research
  • User needs keyword variations
  • User wants to analyze search intent
  • User mentions finding content gaps
  • User needs low-competition keywords

Workflow

  • Identify seed keywords
  • Generate variations and long-tails
  • Classify search intent
  • Identify opportunities
  • Group by topic clusters
  • Prioritize for content

Instructions

Step 1: Gather Seed Keywords

Required inputs:

FieldPurpose
Main topic/productCore focus area
Target audienceWho you're reaching
Business goalTraffic, leads, sales
CompetitorsFor gap analysis
Current rankingsWhat you already rank for

Seed keyword sources:

SourceHow to Use
Product/service namesDirect terms
Customer questionsSupport tickets, FAQs
Competitor contentWhat they rank for
Industry termsJargon, acronyms
Problem statementsPain points

Step 2: Generate Keyword Variations

Variation types:

TypeFormulaExample (seed: "email marketing")
Long-tail[seed] + [modifier]"email marketing for small business"
Question[question word] + [seed]"how to start email marketing"
Comparison[seed] vs [alternative]"email marketing vs social media"
Best/topbest [seed] + [qualifier]"best email marketing software 2026"
How-tohow to [action] + [seed]"how to improve email marketing"
Guide[seed] + guide/tutorial"email marketing guide for beginners"
Tool[seed] + tool/software"email marketing automation tools"
Cost[seed] + cost/pricing"email marketing software pricing"

Modifier categories:

CategoryModifiers
Intentbuy, compare, review, learn, find
Time2026, today, now, quick, fast
Qualitybest, top, free, cheap, premium
Audiencefor beginners, for developers, for small business
Locationnear me, in [city], [country]
Formattemplate, checklist, guide, examples

Step 3: Search Intent Classification

Intent types:

IntentSignal WordsContent TypeFunnel Stage
Informationalhow, what, why, guide, learnBlog, guide, tutorialTop (awareness)
Navigational[brand name], login, websiteLanding page, homepageMiddle
Commercialbest, review, compare, vs, topComparison, reviewMiddle (consideration)
Transactionalbuy, price, discount, orderProduct page, pricingBottom (decision)

Intent identification patterns:

## Informational Intent

- "how to [action]"
- "what is [topic]"
- "why does [thing happen]"
- "[topic] explained"
- "[topic] tutorial"

## Commercial Investigation

- "best [product category]"
- "[product A] vs [product B]"
- "[product] review"
- "[product] alternatives"
- "top 10 [products]"

## Transactional Intent

- "buy [product]"
- "[product] price"
- "[product] discount code"
- "[product] free trial"
- "order [product] online"

## Navigational Intent

- "[brand] login"
- "[brand] website"
- "[brand] support"

Step 4: Keyword Opportunity Analysis

Opportunity scoring:

FactorLow Competition Signal
Search volume100-1,000/month (sweet spot for new sites)
Keyword difficultyUnder 30 (tool-dependent)
SERP featuresFew featured snippets, no ads
Top resultsForums, outdated content, thin pages
Domain authorityLow DA sites ranking

Opportunity matrix:

VolumeDifficultyPriority
HighLowπŸ”₯ Top priority
MediumLowβœ… Quick wins
HighMediumπŸ“ˆ Long-term targets
LowLow⚑ Easy content
HighHigh🎯 Authority builders
LowHigh❌ Skip

Step 5: Question-Based Keywords

Question patterns to generate:

Question WordFocus
HowProcess, tutorial
WhatDefinition, explanation
WhyReasoning, benefits
WhenTiming, triggers
WhereLocation, source
WhichComparison, selection
Can/CouldPossibility, capability
ShouldRecommendation, advice
Is/AreVerification, validation

Question generation template:

## Questions for: [Seed Keyword]

### How questions

- How to [action with keyword]?
- How does [keyword] work?
- How much does [keyword] cost?
- How long does [keyword] take?

### What questions

- What is [keyword]?
- What are the benefits of [keyword]?
- What is the best [keyword]?
- What [keyword] should I use?

### Why questions

- Why is [keyword] important?
- Why use [keyword]?
- Why does [keyword] fail?

### Comparison questions

- [Keyword A] vs [Keyword B]?
- Is [keyword] better than [alternative]?
- What's the difference between [A] and [B]?

Step 6: Topic Cluster Organization

Cluster structure:

## Topic Cluster: [Pillar Topic]

### Pillar Page (main keyword)

- Target: [High-volume keyword]
- Intent: [Informational/Commercial]
- Content: Comprehensive guide (3,000+ words)

### Cluster Content (supporting pages)

| Topic        | Keyword   | Intent   | Internal Link |
| ------------ | --------- | -------- | ------------- |
| [Subtopic 1] | [keyword] | [intent] | β†’ Pillar      |
| [Subtopic 2] | [keyword] | [intent] | β†’ Pillar      |
| [Subtopic 3] | [keyword] | [intent] | β†’ Pillar      |
| [Subtopic 4] | [keyword] | [intent] | β†’ Pillar      |

Cluster example:

## Topic Cluster: Email Marketing

### Pillar Page

- Target: "email marketing guide"
- Intent: Informational
- Content: Ultimate Guide to Email Marketing

### Cluster Content

| Topic           | Keyword                         | Intent        |
| --------------- | ------------------------------- | ------------- |
| Getting started | "how to start email marketing"  | Informational |
| Tools           | "best email marketing software" | Commercial    |
| Templates       | "email marketing templates"     | Informational |
| Automation      | "email marketing automation"    | Commercial    |
| Metrics         | "email marketing KPIs"          | Informational |
| B2B focus       | "b2b email marketing"           | Commercial    |
| List building   | "how to build email list"       | Informational |

Step 7: Competitor Gap Analysis

Gap analysis template:

## Competitor Keyword Gap Analysis

### Competitors Analyzed

1. [Competitor 1 URL]
2. [Competitor 2 URL]
3. [Competitor 3 URL]

### Keywords They Rank For (You Don't)

| Keyword   | Volume | Difficulty | Competitor  | Priority   |
| --------- | ------ | ---------- | ----------- | ---------- |
| [keyword] | [vol]  | [KD]       | [who ranks] | [priority] |

### Content Gaps Identified

| Topic   | Competitor Coverage | Your Coverage | Action        |
| ------- | ------------------- | ------------- | ------------- |
| [topic] | 3 articles          | 0 articles    | Create pillar |
| [topic] | 1 article           | Outdated      | Update        |
| [topic] | None                | None          | First mover   |

Step 8: Keyword Prioritization

Prioritization framework:

CriteriaWeightScore (1-5)
Search volume20%
Keyword difficulty25%
Business relevance25%
Conversion potential20%
Content gap10%

Priority tiers:

## Keyword Priorities

### Tier 1: Immediate (This Month)

- Low difficulty + high relevance
- Quick wins for traffic
  | Keyword | Volume | KD | Intent |
  |---------|--------|----|----|

### Tier 2: Short-term (1-3 Months)

- Medium difficulty + commercial intent
- Revenue-driving content
  | Keyword | Volume | KD | Intent |
  |---------|--------|----|----|

### Tier 3: Long-term (3-6 Months)

- High difficulty + high volume
- Authority-building pillar content
  | Keyword | Volume | KD | Intent |
  |---------|--------|----|----|

Output Format

## Keyword Research: [Topic/Niche]

**Seed keywords:** [List of seeds]
**Target audience:** [Who you're reaching]
**Business goal:** [Traffic/Leads/Sales]

---

### Keyword List

| Keyword | Volume | KD  | Intent | Priority |
| ------- | ------ | --- | ------ | -------- |
|         |        |     |        |          |

### By Search Intent

**Informational:**

- [keywords]

**Commercial:**

- [keywords]

**Transactional:**

- [keywords]

---

### Topic Clusters

[Cluster organization]

---

### Question Keywords

[Question-based keywords for FAQ/content]

---

### Quick Wins (Low KD, Decent Volume)

| Keyword | Volume | KD  | Content Type |
| ------- | ------ | --- | ------------ |
|         |        |     |              |

---

### Content Recommendations

1. [Recommendation 1]
2. [Recommendation 2]
3. [Recommendation 3]

Validation

Before completing:

  • Keywords classified by intent
  • Volume and difficulty included
  • Question keywords generated
  • Topic clusters organized
  • Priority tiers assigned
  • Quick wins identified
  • Content recommendations provided
  • Competitor gaps noted

Error Handling

  • No seed keywords: Ask for main product/service or topic area.
  • Too broad: Narrow with audience, location, or specific use case.
  • No volume data: Note as "volume unknown" and prioritize by relevance.
  • All high difficulty: Focus on long-tail variations or question keywords.
  • No competitors identified: Search top 3 ranking for seed keywords.

Resources

add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall