home / skills / madappgang / claude-code / keyword-cluster-builder

keyword-cluster-builder skill

/plugins/seo/skills/keyword-cluster-builder

This skill helps you build comprehensive keyword clusters from seed terms, mapping topics, intent, and pillar content strategy.

npx playbooks add skill madappgang/claude-code --skill keyword-cluster-builder

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
2.6 KB
---
plugin: seo
updated: 2026-01-20
name: keyword-cluster-builder
description: Techniques for expanding seed keywords and clustering by topic and intent. Use when building keyword lists, planning content calendars, or identifying topic clusters for pillar content strategy.
---
plugin: seo
updated: 2026-01-20

# Keyword Cluster Builder

## When to Use

- Expanding seed keywords to comprehensive lists (50-100+)
- Grouping keywords by topic for pillar content strategy
- Mapping keywords to funnel stages
- Identifying content gaps in keyword coverage

## Expansion Techniques

### Question Modifiers
- What is {keyword}
- How to {keyword}
- Why {keyword}
- When to {keyword}
- Where 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

## 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 I/C/T/N to each cluster
4. **Identify Pillar**: Highest-volume, broadest term = pillar
5. **Map Supporting**: Lower-volume terms support pillar

## Cluster Structure

```
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 Rules

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

## Output Format

When generating keyword clusters, use this format:

```markdown
## Keyword Cluster Report

**Seed Keyword**: {seed}
**Total Keywords**: {count}
**Clusters**: {cluster_count}

### Cluster 1: {cluster_name}
**Intent**: {intent}
**Funnel Stage**: {stage}
**Keywords**:
1. {keyword1} - {estimated_volume}
2. {keyword2} - {estimated_volume}
...

### Cluster 2: {cluster_name}
...
```

Overview

This skill expands seed keywords and builds topic clusters to support pillar content strategy and content calendars. It combines modifier-driven expansion, semantic grouping, and intent mapping to produce organized keyword clusters. Use it to scale keyword lists quickly and to align content with funnel stages and audience needs.

How this skill works

Start by generating large keyword sets from a small number of seeds using question, comparative, intent, and audience modifiers. Then extract seed topics, group keywords by semantic similarity, and assign intent labels (Informational/Commercial/Transactional/Navigational). Identify the highest-volume term as the pillar and map lower-volume supporting keywords into clusters with funnel stage annotations.

When to use it

  • Expanding a handful of seed terms into 50–100+ keywords for content planning
  • Designing pillar pages and supporting cluster content for SEO
  • Mapping keywords to buyer funnel stages to guide conversion-focused content
  • Finding content gaps and prioritizing topics for a content calendar
  • Preparing keyword lists for paid search or topic authority audits

Best practices

  • Start with 3–5 strong seed keywords representing core offerings or topics
  • Use modifier categories (question, comparative, intent, audience) to diversify expansions
  • Cluster by semantic similarity, then refine with search volume and CPC data
  • Label each cluster with intent and funnel stage to drive content formats
  • Choose the highest-volume, broadest term as the pillar and link supporting content to it

Example use cases

  • Build a 12-month content calendar where each pillar maps to monthly themes
  • Create a pillar page and 6–10 supporting posts to establish topical authority
  • Segment keyword lists by funnel stage to prioritize blog posts vs. product pages
  • Generate keyword suggestions for brief writers, including question-based topics
  • Audit existing content to identify gaps and mark opportunities for new clusters

FAQ

How many keywords should each seed expansion produce?

Aim for 50–100+ expanded keywords per seed to ensure broad coverage, then filter by relevance and volume.

How do you choose the pillar keyword?

Select the broadest, highest-volume term that best represents the topic and can support multiple subtopics.