build-clusters
calm-north/seojuice-skills
Build topical authority clusters with pillar-spoke structure, coverage scoring, and interlinking plans.
What is build-clusters?
Build a topical authority cluster from a seed keyword using pillar pages, spoke articles, and internal linking strategy. Use this when planning content architecture around a broad topic, structuring a content silo, or establishing topical authority for SEO.
- Discover 8-20 subtopics from search data, intent patterns, and audience questions
- Organize subtopics into a pillar-spoke cluster map with keyword targeting and intent classification
- Score existing content coverage and identify full gaps, partial gaps, and well-covered areas
- Design a comprehensive pillar page that serves as a hub linking to all spoke articles
- Map internal linking strategy with anchor text and context for pillar, spokes, and cross-spoke connections
- Calculate cluster health metrics (coverage, link health, content quality) and readiness to rank
How to install build-clusters
npx skills add https://github.com/calm-north/seojuice-skills --skill build-clustersHow to use build-clusters
- 1.Gather seed topic, existing content inventory, business relevance, and team content capacity
- 2.Run subtopic discovery using search data (PAA, related searches, autocomplete) and intent patterns (awareness, consideration, implementation, troubleshooting)
- 3.Create a cluster map organizing subtopics into pillar and spoke structure with keyword targets and intent
- 4.Score existing content coverage using a table showing gaps, partial gaps, and covered areas
- 5.Design the pillar page as a 2,000-4,000 word hub with table of contents and links to each spoke
- 6.Map internal linking with specific anchor text and context for pillar-to-spoke, spoke-to-pillar, and spoke-to-spoke connections
- 7.Calculate coverage score, link health, and content quality metrics to assess cluster readiness
- 8.Sequence production starting with the pillar page, then highest-opportunity spokes, then refreshes, then remaining spokes
Use cases
- Planning a content silo around a broad topic like 'project management' with subtopics for tools, methodologies, and use cases
- Auditing existing content to identify gaps in topic coverage and determine which articles to create or refresh
- Designing internal linking architecture to consolidate topical authority across related pages
- Building SEO strategy for a new product category by mapping all customer questions and intent stages
- Organizing competitor content analysis to see which subtopics are underserved on your site
- Content strategists planning multi-page content initiatives
- SEO professionals building topical authority for competitive keywords
- Product marketers structuring content around product categories or features
- Content teams managing editorial calendars across multiple related articles
- Agencies designing content architecture for client sites
build-clusters FAQ
A pillar page is a hub that links to deeper content; it covers topics at an overview level (2,000-4,000 words) and directs readers to spoke pages for details. A mega-article tries to cover everything in depth in one page. Pillar pages distribute authority across the cluster and improve user experience by directing readers to focused content.
Aim for coverage > 70%, link health = 100%, and content quality > 80%. Below 70% coverage, the pillar is unlikely to rank on page 1. A developing cluster (50-70% coverage) may appear on page 2-3, but competitive clusters need 70-90% coverage to compete for page 1.
Aim for 8-20 subtopics per cluster. The exact number depends on the breadth of the seed topic and your content capacity. Start with the highest-opportunity spokes and expand over time rather than trying to build all spokes at once.
No. Every spoke must link to the pillar (mandatory), and the pillar must link to every spoke (mandatory). Spokes should cross-link to 2-4 siblings where contextually natural, but not to every other spoke. Use varied anchor text and only link where it makes sense for the reader.
Score existing content in the coverage scorecard by quality (1-5) and traffic. Full gaps need new pages, partial gaps need refreshes or rewrites, and covered areas may just need internal linking updates. Prioritize refreshing partial-gap pages before creating new spokes.
Full instructions (SKILL.md)
Source of truth, from calm-north/seojuice-skills.
name: build-clusters description: > Build a topical authority cluster from a seed keyword or topic. Use when the user asks about topic clusters, content silos, pillar pages, topical authority, content architecture, or how to structure content around a theme. For finding the right keywords, see find-keywords. For writing individual pieces, see brief. metadata: version: 1.0.0
Build Clusters
Build a topical authority cluster from a seed keyword using pillar-spoke structure, coverage scoring, and interlinking plans.
What is a Topic Cluster?
A topic cluster is a group of interlinked pages that collectively cover a subject area. Google evaluates topical authority at the cluster level — ranking a single page is harder if the site has no supporting content around the topic.
Structure:
- Pillar page — comprehensive overview of the broad topic (targets head term)
- Spoke pages — focused articles covering subtopics (target body/long-tail terms)
- Internal links — every spoke links to the pillar, pillar links to all spokes, spokes cross-link to siblings
Before You Start
Gather this context (ask if not provided):
- Seed topic. The broad subject area to build authority around.
- Existing content. Does the site already have pages on this topic? List them.
- Business relevance. How does this topic connect to the product or service?
- Content capacity. How many pieces can the team produce per month?
Step 1: Subtopic Discovery
From the seed topic, generate subtopics using these methods:
Search-derived:
- People Also Ask questions for the seed keyword
- Related searches at the bottom of SERPs
- Autocomplete suggestions (seed + a, b, c...)
- Competitor content analysis — what subtopics do top-ranking sites cover?
Intent-derived:
- Awareness: "what is [topic]", "why [topic] matters"
- Consideration: "best [topic] tools", "[topic] vs [alternative]"
- Implementation: "how to [topic]", "[topic] tutorial"
- Troubleshooting: "[topic] not working", "common [topic] mistakes"
Audience-derived:
- Beginner questions about the topic
- Advanced practitioner concerns
- Decision-maker evaluation criteria
Aim for 8-20 subtopics per cluster.
Step 2: Cluster Map
Organize subtopics into a structured cluster:
Pillar: [Broad Topic] (head term)
│
├── Spoke: [Subtopic 1] (body term)
│ └── Intent: informational
│
├── Spoke: [Subtopic 2] (body term)
│ └── Intent: commercial investigation
│
├── Spoke: [Subtopic 3] (long-tail)
│ └── Intent: transactional
│
├── Spoke: [Subtopic 4] (long-tail)
│ └── Intent: informational
│
└── ... (8-15 more spokes)
Step 3: Coverage Scoring
Score how well the existing site covers the cluster:
| Subtopic | Existing Page? | Quality (1-5) | Traffic | Gap? |
|---|---|---|---|---|
| [subtopic 1] | /blog/topic-1 | 4 | 500/mo | No |
| [subtopic 2] | — | — | — | Yes |
| [subtopic 3] | /blog/old-post | 2 | 50/mo | Partial (needs refresh) |
- Full gap — no existing page, needs creation
- Partial gap — page exists but is thin, outdated, or off-intent
- Covered — strong existing page, may just need internal linking
Step 4: Pillar Page Design
The pillar page should:
- Cover the topic comprehensively at an overview level (2,000-4,000 words)
- Link to every spoke page for deeper dives
- Be structured as a table of contents for the entire cluster
- Target the highest-volume keyword in the cluster
- Include a summary of each subtopic (2-3 paragraphs) with a link to the full spoke
Pillar page is NOT a mega-article that tries to cover everything in depth. It is a hub that distributes authority and directs readers to the right spoke.
Step 5: Interlinking Plan
Map the internal links:
| From Page | To Page | Anchor Text | Context |
|---|---|---|---|
| Pillar | Spoke 1 | "[subtopic 1] guide" | In the subtopic 1 overview section |
| Spoke 1 | Pillar | "[broad topic]" | In the introduction or conclusion |
| Spoke 1 | Spoke 2 | "[subtopic 2]" | Where subtopic 2 is mentioned contextually |
| Spoke 3 | Spoke 1 | "[subtopic 1]" | Where comparison is relevant |
Rules:
- Every spoke links to the pillar (mandatory)
- Pillar links to every spoke (mandatory)
- Spokes cross-link to 2-4 siblings (where contextually natural)
- Use varied anchor text (not always the exact keyword)
Step 6: Cluster Health Metrics
Score the cluster's readiness to compete:
Coverage Score = (Covered spokes / Total spokes) x 100
Link Health = (Spokes with bidirectional pillar link / Total spokes) x 100
Content Quality = (Spokes scoring 3+ quality / Total spokes) x 100
| Metric | Score | Threshold |
|---|---|---|
| Coverage | [x]% | > 70% to start ranking for pillar keyword |
| Link Health | [x]% | 100% is the target — every spoke must link to pillar and back |
| Content Quality | [x]% | > 80% — clusters with thin spokes dilute authority |
Expected Outcomes by Health Level
| Cluster State | Coverage | Link Health | Content Quality | Expected Result |
|---|---|---|---|---|
| Incomplete | <50% | <70% | Any | Pillar unlikely to rank page 1; spokes rank individually at best |
| Developing | 50-70% | 70-90% | 50-80% | Pillar may appear page 2-3; some spokes rank for long-tail |
| Competitive | 70-90% | 100% | 80-90% | Pillar competes for page 1; most spokes rank for their targets |
| Dominant | >90% | 100% | >90% | Pillar strong on page 1; cluster captures most queries in the topic |
Internal Link Standards per Cluster
| Link Type | Minimum Count | Direction |
|---|---|---|
| Pillar → each spoke | 1 per spoke | Downward — link from the relevant section of the pillar |
| Each spoke → pillar | 1 per spoke | Upward — "our complete [topic] guide" |
| Spoke ↔ sibling spokes | 2-4 per spoke | Lateral — where contextually natural |
| Cross-cluster bridges | 0-2 per cluster | Between hubs — only with genuine topical relevance |
Cluster ready to compete: Coverage > 70%, Link Health = 100%, Content Quality > 80%. Below these thresholds, prioritize filling gaps before expecting the pillar to rank.
Step 7: Production Sequence
Order the content production for maximum impact:
- Pillar page first — even as a draft, it establishes the hub
- Highest-opportunity spokes next — pages targeting gaps with the best opportunity scores
- Refresh existing spokes — update and relink any partial-gap pages
- Remaining spokes — fill out the cluster over time
- Update pillar — add links to each new spoke as it's published
Output Format
Topic Cluster: [seed topic]
Cluster Summary
- Pillar keyword: [keyword] (volume: [x], difficulty: [y])
- Total spokes: [count]
- Existing coverage: [x]% ([n] pages exist, [n] need creation)
- Total cluster volume: [sum of all keyword volumes]
Cluster Map [Visual structure from Step 2]
Coverage Scorecard [Table from Step 3]
Pillar Page Spec
- Target keyword: [keyword]
- Recommended title: [title]
- Structure: [heading outline with spoke links]
Interlinking Plan [Table from Step 5]
Production Roadmap [Ordered list from Step 6 with estimated timelines]
Pro Tip: Use the free Blog Keyword Generator to discover subtopics for your cluster. SEOJuice MCP users get automatic cluster mapping — run
/seojuice:content-strategyto see existing clusters with coverage metrics, or uselist_clustersandget_cluster_detailto check cluster health and identify gaps.
Related skills
More from calm-north/seojuice-skills and the wider catalog.

build-links
Design targeted link acquisition campaigns with prospect scoring, asset mapping, and outreach strategy.

diagnose-seo
Structured diagnostic framework for technical SEO crawlability, indexability, renderability, and signal issues.

find-keywords
Build a prioritized keyword list with intent mapping and opportunity scoring for SEO campaigns.

fix-linking
Design and audit internal link structures using hub-and-spoke topology and PageRank flow logic.

migrate-site
Guide website migrations safely—domain changes, CMS switches, URL restructures—with redirect mapping and monitoring to preserve rankings.

optimize-for-ai
Optimize content to get cited by AI search engines like ChatGPT, Perplexity, and Google AI Overviews.