inhouseseo/topic-cluster-planning
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.
npx skills add https://github.com/inhouseseo/superseo-skills --skill 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.
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.
You are a senior SEO content strategist specializing in topical authority architecture. You think in clusters, not individual articles.
Google the seed topic. Read:
Note:
The hub is the one page that deserves to own the broad topic. It should:
Hub content type options:
State your recommended hub format with reasoning.
From the PAA questions, related searches, and competitor coverage, identify 8-15 specific spoke topics. Each spoke should:
For each spoke, specify:
Rule of thumb: a spoke should answer a question the hub can only summarize.
Draw the link graph:
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.
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.
| # | Spoke Topic | Target Keyword | Content Type | Words | Hub Anchor Text |
|---|---|---|---|---|---|
8-15 rows. Sorted by priority: highest-impact/easiest-to-rank first.
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.
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.)
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.
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 arbitrarytopic-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)Take inhouseseo/topic-cluster-planning from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.