Topic Cluster Planner

Topic cluster planning

by inhouseseo · Apache-2.0 license · ★ 353 on GitHub

Topic cluster planning cover

Use when planning a topic cluster (hub + spokes) for a new content area. The agent researches the space, identifies the hub topic, maps the spokes, and produces a specific content plan with internal linking strategy.

---
name: topic-cluster-planning
description: Use when planning a topic cluster (hub + spokes) for a new content area. The agent researches the space, identifies the hub topic, maps the spokes, and produces a specific content plan with internal linking strategy.
---

# Topic Cluster Planning

Builds a hub-and-spoke architecture for a new content area. Hub = a broad pillar page that owns the topic. Spokes = specific articles that target long-tail keywords and link up to the hub. Done right, this signals topical authority to Google and concentrates link equity on the pages that matter.

## Input

**Seed topic or broad keyword** (required). Example: "email marketing", "keto diet", "small business accounting".

Optionally: your domain, so the agent can check what you've already published in this space.

## Role

You are a senior SEO content strategist specializing in topical authority architecture. You think in clusters, not individual articles.

Overview

Builds a hub-and-spoke architecture for a new content area. Hub = a broad pillar page that owns the topic. Spokes = specific articles that target long-tail keywords and link up to the hub. Done right, this signals topical authority to Google and concentrates link equity on the pages that matter.

Manual install (npx, ZIP)
Claude Codenpx skills add inhouseseo/superseo-skills --skill topic-cluster-planning -g -a claude-code
Claude Code (degit)npx degit inhouseseo/superseo-skills/skills/topic-cluster-planning#main ~/.claude/skills/topic-cluster-planning
Claude.ai / desktopZip the folder and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md6.6 KB
Read SKILL.md here
inhouseseo/main1 file shown
SKILL.md
Show the full text138 lines

Topic Cluster Planning

Builds a hub-and-spoke architecture for a new content area. Hub = a broad pillar page that owns the topic. Spokes = specific articles that target long-tail keywords and link up to the hub. Done right, this signals topical authority to Google and concentrates link equity on the pages that matter.

Input

Seed topic or broad keyword (required). Example: "email marketing", "keto diet", "small business accounting".

Optionally: your domain, so the agent can check what you've already published in this space.

Role

You are a senior SEO content strategist specializing in topical authority architecture. You think in clusters, not individual articles.

Step 1: Research the Topic Space

Google the seed topic. Read:

  • The top 10 results for the broad keyword
  • The People Also Ask questions
  • The "Searches related to" at the bottom of the SERP
  • 2-3 major publications in the space to see how they structure their content

Note:

  • Who dominates the broad keyword? (This tells you the difficulty level.)
  • What sub-topics emerge from PAA and related searches?
  • What specific questions do people ask?

Use only PAA questions and related searches you actually saw — don't pad the spoke list with invented queries. If the SERP shows few, say so and lean harder on competitor coverage.

Step 2: Identify the Hub

The hub is the one page that deserves to own the broad topic. It should:

  • Target the broad/seed keyword directly
  • Cover the topic comprehensively at a high level (don't go deep on every sub-topic)
  • Link out to all the spoke articles

Hub content type options:

  • Ultimate guide ("The Complete Guide to X") — best for broad informational topics
  • Pillar + chapters (pillar page with a TOC linking to deep-dive chapters) — best for very broad topics with clear sub-chapters
  • Category page with curated featured content — best for product/service topics

State your recommended hub format with reasoning.

Step 3: Map the Spokes

From the PAA questions, related searches, and competitor coverage, identify 8-15 specific spoke topics. Each spoke should:

  • Target a long-tail keyword or specific question
  • Go deeper on one narrow sub-topic than the hub can
  • Link back to the hub (primary)
  • Link to 2-3 related spokes

For each spoke, specify:

  • Target keyword / question it answers
  • Content type (how-to / definition / comparison / case study / listicle)
  • Approximate word count
  • Why it matters for the cluster (what sub-topic does it own?)

Rule of thumb: a spoke should answer a question the hub can only summarize.

Step 4: Map the Internal Linking

Draw the link graph:

  • Every spoke links to the hub with a keyword-rich anchor
  • Hub links to every spoke (usually in a "In this guide" TOC or a "Related deep dives" section)
  • Related spokes link to each other (but sparingly — don't over-link)
  • External links from the hub to 3-5 authoritative sources in the space

Critical: the first link from any spoke TO the hub is what Google's algorithm weights most heavily. Make sure it's contextual (within the article body), with a descriptive anchor text.

Step 5: Publishing Order

Don't publish the hub first. Publish 3-4 high-quality spokes first, then the hub with links to them. Then publish the remaining spokes, each linking back to the now-established hub.

This prevents the hub from launching as a link-less orphan that has nothing to point to.

Step 6: Output

Cluster Overview
  • Seed topic | Estimated difficulty (Easy / Moderate / Hard) based on SERP competition
  • Realistic timeline to build out (how many articles, how many months)
Hub
  • Recommended format (Ultimate guide / Pillar + chapters / Category)
  • Target keyword (the broad seed)
  • Main H2 sections (roughly 5-10)
  • Approximate word count
  • What the hub should NOT cover in depth (save that for spokes)
Spoke List
# Spoke Topic Target Keyword Content Type Words Hub Anchor Text

8-15 rows. Sorted by priority: highest-impact/easiest-to-rank first.

Publishing Sequence
  1. Month 1: 3-4 spokes (pick from rows 1-4)
  2. Month 2: Publish the hub, link it to the published spokes
  3. Month 3-4: Remaining spokes, each linking back to the hub

A simple list showing which spokes link to which other spokes. Not every spoke needs to link to every other — just the naturally related ones.

External Linking Strategy

3-5 authoritative external sources the hub should cite. (Not competitors — actual authoritative sources: research papers, industry standards, government/university resources, or the primary creators of the concepts you're discussing.)

Success Metrics
  • Month 3: Hub should rank somewhere in top 50 for the seed keyword
  • Month 6: At least 2-3 spokes ranking in top 20 for their long-tail keywords
  • Month 9: Hub ranking top 20, cluster driving consistent organic traffic
  • Month 12: Cluster becomes a topical authority signal for the whole domain

What to Ignore

  • Publishing everything at once — Google needs time to see the cluster form. Spread it over 3-4 months.
  • Over-linking between spokes — if it doesn't feel natural in the article, skip it
  • Keyword density in the hub — the hub is about breadth, not keyword stuffing

Next Step

For each spoke, use content-brief with the spoke's target keyword to produce a writer-ready brief. Then write-content to write the article.

Bundled references

Load from references/ only when the step calls for them.

  • first-link-weight-evidence.md — the evidence behind "the first link in the body is weighted most heavily" and why it matters for spoke → hub linking (Step 4, when briefing the writer on anchor placement)
  • publishing-sequence-decisions.md — the full decision framework for "don't publish the hub first" and the exceptions (Step 5, when the user pushes back on the staggered launch)
  • spoke-selection-worked-example.md — a full cluster worked end-to-end (seed → hub → 12 spokes → link map) for a sample niche, to anchor Step 3 when spoke selection feels arbitrary
  • topic-cluster-strategy.md — the theory behind hub-and-spoke architecture and topical authority signals (background, optional)
  • pillar-page-template.md — exact H1/H2 structure for the hub page (Step 2, after the hub format is chosen)
1---
2name: topic-cluster-planning
3description: Use when planning a topic cluster (hub + spokes) for a new content area. The agent researches the space, identifies the hub topic, maps the spokes, and produces a specific content plan with internal linking strategy.
4---
5 
6# Topic Cluster Planning
7 
8Builds a hub-and-spoke architecture for a new content area. Hub = a broad pillar page that owns the topic. Spokes = specific articles that target long-tail keywords and link up to the hub. Done right, this signals topical authority to Google and concentrates link equity on the pages that matter.
9 
10## Input
11 
12**Seed topic or broad keyword** (required). Example: "email marketing", "keto diet", "small business accounting".
13 
14Optionally: your domain, so the agent can check what you've already published in this space.
15 
16## Role
17 
18You are a senior SEO content strategist specializing in topical authority architecture. You think in clusters, not individual articles.
19 
20## Step 1: Research the Topic Space
21 
22Google the seed topic. Read:
23- The top 10 results for the broad keyword
24- The People Also Ask questions
25- The "Searches related to" at the bottom of the SERP
26- 2-3 major publications in the space to see how they structure their content
27 
28Note:
29- Who dominates the broad keyword? (This tells you the difficulty level.)
30- What sub-topics emerge from PAA and related searches?
31- What specific questions do people ask?
32 
33Use only PAA questions and related searches you actually saw — don't pad the spoke list with invented queries. If the SERP shows few, say so and lean harder on competitor coverage.
34 
35## Step 2: Identify the Hub
36 
37The hub is the one page that deserves to own the broad topic. It should:
38- Target the broad/seed keyword directly
39- Cover the topic comprehensively at a high level (don't go deep on every sub-topic)
40- Link out to all the spoke articles
41 
42**Hub content type options:**
43- **Ultimate guide** ("The Complete Guide to X") — best for broad informational topics
44- **Pillar + chapters** (pillar page with a TOC linking to deep-dive chapters) — best for very broad topics with clear sub-chapters
45- **Category page with curated featured content** — best for product/service topics
46 
47State your recommended hub format with reasoning.
48 
49## Step 3: Map the Spokes
50 
51From the PAA questions, related searches, and competitor coverage, identify 8-15 specific spoke topics. Each spoke should:
52- Target a long-tail keyword or specific question
53- Go deeper on one narrow sub-topic than the hub can
54- Link back to the hub (primary)
55- Link to 2-3 related spokes
56 
57For each spoke, specify:
58- Target keyword / question it answers
59- Content type (how-to / definition / comparison / case study / listicle)
60- Approximate word count
61- Why it matters for the cluster (what sub-topic does it own?)
62 
63**Rule of thumb:** a spoke should answer a question the hub can only summarize.
64 
65## Step 4: Map the Internal Linking
66 
67Draw the link graph:
68- Every spoke links to the hub with a keyword-rich anchor
69- Hub links to every spoke (usually in a "In this guide" TOC or a "Related deep dives" section)
70- Related spokes link to each other (but sparingly — don't over-link)
71- External links from the hub to 3-5 authoritative sources in the space
72 
73**Critical:** the first link from any spoke TO the hub is what Google's algorithm weights most heavily. Make sure it's contextual (within the article body), with a descriptive anchor text.
74 
75## Step 5: Publishing Order
76 
77Don't publish the hub first. Publish 3-4 high-quality spokes first, then the hub with links to them. Then publish the remaining spokes, each linking back to the now-established hub.
78 
79This prevents the hub from launching as a link-less orphan that has nothing to point to.
80 
81## Step 6: Output
82 
83### Cluster Overview
84- Seed topic | Estimated difficulty (Easy / Moderate / Hard) based on SERP competition
85- Realistic timeline to build out (how many articles, how many months)
86 
87### Hub
88- Recommended format (Ultimate guide / Pillar + chapters / Category)
89- Target keyword (the broad seed)
90- Main H2 sections (roughly 5-10)
91- Approximate word count
92- What the hub should NOT cover in depth (save that for spokes)
93 
94### Spoke List
95 
96| # | Spoke Topic | Target Keyword | Content Type | Words | Hub Anchor Text |
97|---|---|---|---|---|---|
98 
998-15 rows. Sorted by priority: highest-impact/easiest-to-rank first.
100 
101### Publishing Sequence
102 
1031. **Month 1**: 3-4 spokes (pick from rows 1-4)
1042. **Month 2**: Publish the hub, link it to the published spokes
1053. **Month 3-4**: Remaining spokes, each linking back to the hub
106 
107### Internal Link Map
108A simple list showing which spokes link to which other spokes. Not every spoke needs to link to every other — just the naturally related ones.
109 
110### External Linking Strategy
1113-5 authoritative external sources the hub should cite. (Not competitors — actual authoritative sources: research papers, industry standards, government/university resources, or the primary creators of the concepts you're discussing.)
112 
113### Success Metrics
114- **Month 3**: Hub should rank somewhere in top 50 for the seed keyword
115- **Month 6**: At least 2-3 spokes ranking in top 20 for their long-tail keywords
116- **Month 9**: Hub ranking top 20, cluster driving consistent organic traffic
117- **Month 12**: Cluster becomes a topical authority signal for the whole domain
118 
119## What to Ignore
120 
121- **Publishing everything at once** — Google needs time to see the cluster form. Spread it over 3-4 months.
122- **Over-linking between spokes** — if it doesn't feel natural in the article, skip it
123- **Keyword density in the hub** — the hub is about breadth, not keyword stuffing
124 
125## Next Step
126 
127For each spoke, use `content-brief` with the spoke's target keyword to produce a writer-ready brief. Then `write-content` to write the article.
128 
129## Bundled references
130 
131Load from `references/` only when the step calls for them.
132 
133- **`first-link-weight-evidence.md`** — the evidence behind "the first link in the body is weighted most heavily" and why it matters for spoke → hub linking (Step 4, when briefing the writer on anchor placement)
134- **`publishing-sequence-decisions.md`** — the full decision framework for "don't publish the hub first" and the exceptions (Step 5, when the user pushes back on the staggered launch)
135- **`spoke-selection-worked-example.md`** — a full cluster worked end-to-end (seed → hub → 12 spokes → link map) for a sample niche, to anchor Step 3 when spoke selection feels arbitrary
136- **`topic-cluster-strategy.md`** — the theory behind hub-and-spoke architecture and topical authority signals (background, optional)
137- **`pillar-page-template.md`** — exact H1/H2 structure for the hub page (Step 2, after the hub format is chosen)
138 
View all files on GitHub →

Details

License
Apache-2.0
Stars on the repo
★ 353
Checked
Source
inhouseseo/superseo-skills ↗
Creator
inhouseseo · 9 listings
View creator

Similar skills

See all →
AgentPhase 2: Foundation Scaffoldingmsitarzewski/agency-agents · by msitarzewski> Duration: 3-5 days | Agents: 6 | Gate Keepers: DevOps Automator + Evidence Collector★ 154k GitHub starsAgentNEXUS Network Frameworkmsitarzewski/agency-agents · by msitarzewski> NEXUS transforms The Agency's independent AI specialists into a synchronized intelligence network. This is not a prompt collection — it…★ 154k GitHub starsSkillAnsoff Matrix Generatorphuryn/pm-skills · by phurynGenerate an Ansoff Matrix analysis mapping growth strategies across market penetration, market development, product development, and diversification. Use when considering growth options, planning market expansion, or evaluating strategic growth paths.★ 26.6k GitHub starsSkillArchitecture Advisorshadcn/improve · by shadcnSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.★ 9.2k GitHub starsSkillCareer Skills TranslatorParamchoudhary/ResumeSkills · by ParamchoudharyTranslate skills from one industry to another, identify transferable skills★ 2.4k GitHub starsSkillMarketing Skills CollectionLeoYeAI/openclaw-marketing-skills · by LeoYeAIA collection of 37 battle-tested marketing skills for OpenClaw agents. Use when you want to install or reference any marketing skill including: CRO (page-cro, signup-flow-cro, onboarding-cro, form-cro, popup-cro, paywall-upgrade-cro), copywriting, copy-editing, cold-email, email-sequence, social-content, seo-audit, ai-seo, programmatic-seo, site-architecture, schema-markup, content-strategy, paid-ads, ad-creative, ab-test-setup, analytics-tracking, referral-program, free-tool-strategy, churn-prevention, revops, sales-enablement, launch-strategy, pricing-strategy, competitor-alternatives, marketing-ideas, marketing-psychology, lead-magnets, product-marketing-context, and data connectors (google-ads-connect, search-console-connect, meta-ads-connect, x-twitter-connect). Start with product-marketing-context to set up your product context document, then use any other skill naturally. Powered by MyClaw.ai.★ 1k GitHub stars

More from inhouseseo

SkillE-E-A-T Signal Auditorinhouseseo/superseo-skills · by inhouseseoUse when auditing a page for E-E-A-T signals. The agent reads the page and scores Experience, Expertise, Authoritativeness, and Trustworthiness — then tells you exactly what to add to each dimension.★ 353 GitHub starsSkillExpert Knowledge Extractorinhouseseo/superseo-skills · by inhouseseoUse when extracting first-party expertise from a subject-matter expert before writing content. Produces a knowledge document of contrarian takes, specific examples, and surprising outcomes that AI can't fabricate.★ 353 GitHub starsSkillFeatured Snippet Optimizerinhouseseo/superseo-skills · by inhouseseoUse when you want to win a featured snippet for a keyword you already rank for. The agent checks the current snippet format, analyzes your content, and rewrites the relevant section to match what Google wants.★ 353 GitHub starsSkillContent Rewriterinhouseseo/superseo-skills · by inhouseseoUse when rewriting or refreshing an existing page that's underperforming. The agent fetches the URL, analyzes the current content, researches the SERP, and rewrites using the full anti-AI-slop ruleset — no data exports needed.★ 353 GitHub starsSkillKeyword Ranking Deep Diveinhouseseo/superseo-skills · by inhouseseoUse when planning to rank for a specific keyword. The agent Googles it, reads the top 10, classifies intent, reads the top 3 competitor pages, and produces a 90-day ranking plan with intent, SERP analysis, and content recommendations.★ 353 GitHub starsSkillPage Audit & Recommendationsinhouseseo/superseo-skills · by inhouseseoUse when auditing a specific page's SEO performance, content quality, and competitive position. The agent fetches the URL, Googles the primary keyword, reads the top 3 competitors, and produces a full 7-dimension audit — no exports, no analytics access required.★ 353 GitHub stars