Skip to main content
skill CX Codex

keyword-research-and-clustering — Claude Code skill: research, expand

keyword-research-and-clustering — a skill for Claude Code, Codex, Cursor, and other agents that researches keywords, expands seed terms, and groups results by topic and intent.

MIT 261 installs ★ 114 updated 2026-09-18

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add manojbajaj95/claude-gtm-plugin --skill keyword-research-and-clustering -a claude-code
Open on GitHub

What keyword-research-and-clustering does

The skill activates on phrases like "keyword research", "keyword clustering", "content planning", or "6 circles method" — no explicit slash command needed.

The core method is the 6 circles approach: from a single seed keyword, the skill builds a pyramid of 13 connected topics — one pillar, three supporting themes, nine specific pieces. Expansion uses question, comparison, and intent modifiers. Community mining instructions cover Reddit, Quora, and YouTube comments with concrete search patterns. The skill also lists free tools (Google Keyword Planner, Ahrefs Free Generator, Answer the Public, AlsoAsked) and a manual SERP analysis framework for gauging content depth, freshness, and authority gaps.

Before asking questions, the skill reads strategy/brand.md, about/me.md, content/ideas.md, and content/calendar.md for niche, audience, and constraints. Generated drafts go to content/<platform>/drafts/YYYY-MM-DD_<slug>.md. Without those files, it asks for niche, audience, business goal, and existing site — four inputs, nothing more.

What it helps with

  • Expand a seed keyword into a list of 50–100 related terms
  • Cluster keywords by topic and intent for a content plan
  • Build a pillar content structure using the 6 circles method
  • Map keywords to funnel stages
  • Generate a content calendar topic list without paid SEO tools

Example prompts for the agent

  • Run keyword research for the 'personal finance' niche, target audience is young professionals
  • Expand the seed keyword 'email marketing' and cluster results by intent
  • Build a 6 circles content plan for 'SaaS onboarding' using strategy/brand.md

How to install keyword-research-and-clustering

1Skills CLI (Vercel)

npx skills add manojbajaj95/claude-gtm-plugin --skill keyword-research-and-clustering -a claude-code

2Manually: put the files in place

~/.claude/skills/keyword-research-and-clustering/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/keyword-research-and-clustering/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about keyword-research-and-clustering

How do I install keyword-research-and-clustering in Claude Code?

Run npx skills add manojbajaj95/claude-gtm-plugin --skill keyword-research-and-clustering -a claude-code. The skill will then be available at ~/.claude/skills/keyword-research-and-clustering/SKILL.md.

What does the keyword-research-and-clustering skill do?

It researches keywords from free sources, expands them with modifiers, and clusters the results by topic and intent. The output is a structured content strategy artifact ready to act on.

Does this skill require a paid SEO subscription?

No. It works with free tools — Google Keyword Planner, Google Trends, Ahrefs Free Generator, and Answer the Public — plus manual SERP analysis. No paid plan is needed.

Source text

SKILL.md · MIT
---
name: keyword-research-and-clustering
description: Research, expand, and cluster keywords for content strategy. Use when planning content topics, building keyword lists, expanding seed keywords, clustering by topic and intent, or mapping keywords to funnel stages. Triggers on "keyword research," "keyword expansion," "keyword clustering," "content topics," "what to write about," "topic ideation," "content planning," "6 circles method," "seed keywords," "keyword difficulty," "search volume," "intent mapping," "pillar content strategy," or "content calendar planning." For SEO optimization and auditing, see seo-and-aeo-strategy.
---

# Keyword Research & Clustering

## Workspace Context

Read bootstrap context before asking questions: `strategy/brand.md` for brand, audience, offer, channels, tools, constraints, and metrics; `about/me.md` for personal voice; `content/ideas.md` and `content/calendar.md` for content planning. Use legacy product-marketing context files only as fallback. Save generated drafts to `content/<platform>/drafts/YYYY-MM-DD_short-topic-slug.md`, and route durable learnings back to `strategy/brand.md`, `about/me.md`, or `content/ideas.md`.

## Operating Contract

This skill is self-contained for its frontmatter scope: use its local instructions, references, scripts, and assets as the playbook; ask only for missing task-specific inputs; hand off to adjacent skills instead of expanding scope; and return an actionable artifact, decision, plan, draft, or diagnostic.



Research keywords, expand them systematically, cluster by topic and intent, and prioritize for content strategy — all without expensive tools.

---

## Required Input

Ask the user for:
1. **Niche/Industry** — What space are you in?
2. **Target Audience** — Who are you writing for?
3. **Business Goal** — Traffic, leads, sales, authority?
4. **Existing Content** — Do you have a site/blog already?

---

## The 6 Circles Method

Generate 13 content ideas from a single seed keyword using nested topic clusters.

```
                    ┌─────────────────────┐
                    │   PRIMARY KEYWORD   │  ← 1 pillar topic
                    │   (Largest Circle)  │
                    └─────────────────────┘
                              │
            ┌─────────────────┼─────────────────┐
            ▼                 ▼                 ▼
     ┌───────────┐     ┌───────────┐     ┌───────────┐
     │ Sub-topic │     │ Sub-topic │     │ Sub-topic │  ← 3 supporting themes
     │     A     │     │     B     │     │     C     │
     └───────────┘     └───────────┘     └───────────┘
            │                 │                 │
      ┌─────┼─────┐     ┌─────┼─────┐     ┌─────┼─────┐
      ▼     ▼     ▼     ▼     ▼     ▼     ▼     ▼     ▼
     [1]   [2]   [3]   [4]   [5]   [6]   [7]   [8]   [9]  ← 9 content pieces
```

**Process:**
1. Identify primary keyword — high-traffic, high-intent topic in your niche
2. Brainstorm 3 sub-topics — related themes that support the primary
3. Generate 3 pieces per sub-topic — specific articles addressing aspects of each

### Content Types for Supporting Pieces

| Type | Example |
|------|---------|
| How-to Guide | "How to [achieve outcome] with [method]" |
| Comparison | "[Option A] vs [Option B]: Which is better for [use case]" |
| List Post | "[Number] [adjective] ways to [achieve result]" |
| Case Study | "How [persona] achieved [result] using [approach]" |
| Trend Analysis | "[Topic] trends in [year]: What's changing" |
| Beginner Guide | "[Topic] for beginners: Everything you need to know" |
| Tool Review | "Best [category] tools for [audience/use case]" |
| Problem-Solution | "Why [problem happens] and how to fix it" |

---

## Seed Generation (50–100 Keywords)

### Google Autocomplete & PAA
- Type `[keyword]` + a–z variations
- "how to [keyword]", "best [keyword] for", "[keyword] vs"
- Capture People Also Ask questions from SERP

### Community Mining

| Source | What to Extract |
|--------|-----------------|
| **Reddit** | Pain points, questions, terminology |
| **Quora** | Question patterns, answer gaps |
| **Industry Forums** | Niche-specific problems |
| **YouTube Comments** | Objections, confusion points |
| **Amazon Reviews** | Customer language, unmet needs |

### Reddit Mining Protocol

Search queries:
```
site:reddit.com "[niche]" + "how do I"
site:reddit.com "[niche]" + "help"
site:reddit.com "[niche]" + "struggling with"
site:reddit.com "[niche]" + "recommend"
site:reddit.com "[niche]" + "vs"
```

Extract: Questions asked repeatedly (content opportunities), complaints about existing solutions (angle differentiation), terminology and slang (keyword variations), upvote patterns (demand signals).

---

## Keyword Expansion Techniques

### Modifier Categories

**Question modifiers:**
- What is {keyword} / How to {keyword} / Why {keyword} / When to {keyword}

**Comparative modifiers:**
- {keyword} vs {competitor} / {keyword} alternatives / best {keyword} / {keyword} comparison

**Intent modifiers:**
- {keyword} guide / {keyword} tutorial / {keyword} examples / {keyword} template / buy {keyword} / {keyword} pricing

**Audience modifiers:**
- {keyword} for beginners / {keyword} for {industry} / {keyword} for small business / {keyword} for enterprise

### Expansion Procedure

1. Extract current topic scope and any exclusions
2. Propose expansions: synonyms, related terms, acronyms
3. Add explicit exclusions for common false positives
4. Document "why" for each change
5. Keep query count manageable — merge near-duplicates instead of adding many variations

---

## Free Tool Arsenal

### Demand Research

| Tool | Use For | Access |
|------|---------|--------|
| **Google Keyword Planner** | Volume ranges, competition | ads.google.com (free account) |
| **Google Trends** | Seasonality, rising topics | trends.google.com |
| **Ahrefs Free Generator** | 150 suggestions with difficulty | ahrefs.com/keyword-generator |
| **Ubersuggest** | 3 searches/day with metrics | neilpatel.com/ubersuggest |

### Intent Discovery

| Tool | Use For | Access |
|------|---------|--------|
| **Google Autocomplete** | Real-time user queries | Type in search bar |
| **People Also Ask** | Question-based content | Scroll down in SERP |
| **Answer the Public** | Visual question maps | answerthepublic.com |
| **AlsoAsked** | PAA clustering | alsoasked.com |

---

## Competition Assessment (Manual SERP Analysis)

For each target keyword, analyze top 10 results:

| Signal | What to Look For | Opportunity If... |
|--------|------------------|-------------------|
| **Content Depth** | Word count, comprehensiveness | Top results are thin (<1000 words) |
| **Freshness** | Publication date, last update | Top results are 2+ years old |
| **Format Match** | Does format match intent? | Results don't match searcher need |
| **Authority Gap** | Domain strength of rankers | Small sites ranking (not all big brands) |
| **Content Gaps** | Missing subtopics, unanswered questions | PAA questions not covered |

### Sweet Spot Targets by Site Stage

| Site Stage | Monthly Search Volume | Competition Level |
|------------|----------------------|-------------------|
| New site (0–6 months) | 100–500 | Low |
| Growing site (6–18 months) | 500–2,000 | Low–Medium |
| Established site (18+ months) | 1,000–10,000 | Medium |

---

## Clustering Algorithm

1. **Extract seed topics** — Identify main themes from expanded list
2. **Group by semantic similarity** — Keywords with overlapping meaning
3. **Map intent** — Assign Informational / Commercial / Transactional / Navigational
4. **Identify pillar** — Highest-volume, broadest term = pillar page
5. **Map supporting** — Lower-volume terms support pillar

### Cluster Structure Example

```
PILLAR: "content marketing" (highest volume)
├── CLUSTER: "content marketing strategy" (commercial)
│   ├── content marketing plan template
│   ├── content marketing framework
│   └── how to create content marketing strategy
├── CLUSTER: "content marketing examples" (informational)
│   ├── B2B content marketing examples
│   ├── content marketing case studies
│   └── content marketing success stories
└── CLUSTER: "content marketing tools" (commercial)
    ├── best content marketing tools
    ├── content marketing software
    └── content marketing platforms
```

### Intent Classification

| Signal | Intent |
|--------|--------|
| "what is", "how to", "guide" | Informational |
| "best", "vs", "review", "compare" | Commercial |
| "buy", "price", "discount", brand | Transactional |
| Brand name, specific product | Navigational |

---

## Prioritization Matrix

Score each keyword 1–10:

| Keyword | Demand | Competition | Intent Fit | Opportunity |
|---------|--------|-------------|------------|-------------|
| [keyword] | [1–10] | [1–10, lower=easier] | [1–10] | Demand − Competition |

**Prioritize:** Opportunity score > 3, Intent fit > 6

---

## Output Format

```markdown
# Keyword Research: [Niche/Topic]

## 6 Circles Content Plan

### Primary Keyword: [keyword]
- Monthly searches: [range]
- Competition: [low/medium/high]
- Intent: [informational/commercial/transactional]

### Sub-topic A: [theme]
1. [Article idea] — [target keyword] — [volume]
2. [Article idea] — [target keyword] — [volume]
3. [Article idea] — [target keyword] — [volume]

### Sub-topic B: [theme]
4–6. [...]

### Sub-topic C: [theme]
7–9. [...]

## Prioritized Content Queue

| Priority | Topic | Keyword | Volume | Difficulty | Opportunity |
|----------|-------|---------|--------|------------|-------------|
| 1 | [topic] | [keyword] | [vol] | [1–10] | [score] |

## Quick Wins (Low Competition, Decent Volume)
- [keyword 1] — [rationale]
- [keyword 2] — [rationale]

## Content Gaps Found
- [gap 1] — competitors missing [what]
- [gap 2] — outdated content on [topic]

## Community Insights
- Top pain point: [description]
- Common question: [question]
- Terminology used: [terms]
```

---

## Related Skills

- **seo-and-aeo-strategy** — SEO optimization and AI search visibility
- **content-strategy-and-planning** — Detailed content strategy from keyword research
- **content-creation-and-marketing** — Writing the actual content
- **seo-and-aeo-strategy** — Building SEO page plans at scale from keyword data

© manojbajaj95 · MIT · manojbajaj95/claude-gtm-plugin

Similar skills

All skills for SEO and GEO →
keyword-clustering akii-technologies-ltd The keyword-clustering Claude Code skill sorts keywords into topic groups and maps them to search intent. It activates on a keyword list or a request to plan site content. CX Codex +1 ★ 80repo stars seo-keyword rampstackco seo-keyword discovers search queries worth ranking for, classifies them by intent, and groups them into topic clusters. Helps you prioritize what to write based on traffic potential and competitive difficulty. CX Codex +1 312installs Keyword Research — Google Suggest, Intent & Long-Tail axel-belfort Keyword Research — Google Suggest, Intent & Long-Tail is an MCP server for Google Suggest keyword research, intent classification, and long-tail variants for content, PPC, and competitor analysis. CX Codex +1 6,583installs keyword-research kostja94 keyword-research — an SEO research skill that finds target keywords, reads search intent and builds a topical map. Useful when you need a content plan tied to search demand. CX Codex +1 1,600installs seo-keyword-cluster-builder secondsky seo-keyword-cluster-builder groups search queries into topical clusters, designs pillar-and-hub architectures, and plans bidirectional internal linking. CX Codex +1 444installs seo-keyword-gap-audit rampstackco The seo-keyword-gap-audit skill compares your site's organic footprint against competitors and flags keywords they rank for that you don't. Use it to plan content investment, spot quick wins, or scope market entry. CX Codex +1 287installs

From the same set41

The whole set →
competitor-analysis competitor-analysis — a skill for competitive analysis and comparison page creation. Gathers competitor data, builds SWOT matrices, feature comparisons, and sales battle cards. CX Codex +1 284installs blog-writing-specialist blog-writing-specialist turns raw notes, brain dumps, and technical data into structured developer posts, architecture breakdowns, and step-by-step guides. CX Codex +1 269installs marketing-automation This skill helps plan marketing automation in HubSpot, Marketo, and similar tools, covering lead scoring, email sequences, and workflow design. CX Codex +1 264installs outbound-email-strategy outbound-email-strategy builds cold B2B outreach sequences, writes low-friction subject lines, and plans follow-up timing. Useful for SDR workflows and founder-led sales campaigns. CX Codex +1 263installs pricing-strategy The pricing-strategy skill helps plan SaaS pricing, packaging, and willingness-to-pay research. Use it when setting prices or reconsidering tiers and payment models. CX Codex +1 251installs product-market-fit-analysis product-market-fit-analysis is a Claude Code skill that assesses product-market fit through retention, customer surveys, and demand signals. It helps weigh iteration against scaling. CX Codex +1 251installs community-building community-building is a Claude Code skill that guides an agent through building online communities, from platform selection to ambassador programs. It covers channel architecture, onboarding, and moderation. CX Codex +1 246installs sales-and-revenue-operations sales-and-revenue-operations is a Claude Code skill for planning sales workflows, defining an ICP, qualifying deals, and structuring lead operations. CX Codex +1 246installs

Project sponsors

Companies that keep this analytics open