Content and On-Page SEO skill 04 of 13
Topical Maps and Content Clusters SKILL.md
The Topical Maps skill makes Claude, Codex or another AI agent plan every page a site needs to cover a subject properly. It defines the core topic and entities, breaks the subject into a pillar, clusters and supporting pages with one intent each, maps your existing content, flags overlaps and gaps, plans hub-and-spoke internal links before writing starts, and sequences publishing in batches your team can deliver.
topical-map/SKILL.md, version 1.0.0, 1,143 words.
By Afeez Adebayo, Marketing, SEO & Growth Expert with 10+ years of experience.
Created 10 October 2026. Updated 10 October 2026. Free to use under CC BY 4.0.
A topical map is a plan of every page a site needs to cover a subject properly, how those pages relate to each other and in what order to publish them. It turns a keyword list into a structure: a hub that covers the topic broadly, clusters that cover each subtopic, and links that tie them together.
This skill builds the map from the business outward, so the site becomes the obvious source on the topics it sells, rather than a pile of loosely related posts.
Operating principles
- Business first. Topics are chosen because they lead to the product, service or audience the business serves.
- One page, one intent. Each node in the map answers one main need; overlapping nodes are merged before anything is written.
- Cover the topic, not the keyword list. Include the subtopics a knowledgeable reader expects, even when tools show low volume.
- Links are part of the plan. Every page knows its parent, siblings and children before it is written.
- Depth before breadth. Finish a cluster before starting the next; a half-covered topic signals little.
When to use, and when not to
Use it for new sites and sections, resource centres, blog resets, entering a new product area, and when an existing blog has no structure.
Don't use it for one-off pages (content-brief), for the link mechanics of an existing site (the Technical SEO internal linking skill) or for listing keywords without structure (keyword-research).
Inputs to ask for, in one message
- The business, its products or services, audience and markets.
- The topic or topics to map, and how they connect to revenue.
- Keyword research or Search Console data, if available.
- A list of existing pages with URLs, titles and main queries.
- Competitors seen as authorities on the topic.
- Publishing capacity per month and any deadlines.
Raw SKILL.md file
This is the exact file agents read, including the credit header and licence notice. Save it as topical-map/SKILL.md.
--- name: topical-map description: "Plan a topic the way search engines and readers understand it: define the core entity and audience, break the topic into pillars, clusters and supporting pages with one intent each, map existing pages, find gaps, set hub-and-spoke internal links, and sequence publishing so authority builds where the business needs it. Use whenever someone asks for a topical map, topic clusters, pillar pages, content hubs, a content plan or editorial calendar for SEO, topical authority, or how to organise a blog or resource centre." license: CC-BY-4.0 metadata: author: Afeez Adebayo author_url: https://afeezadebayo.com author_linkedin: https://www.linkedin.com/in/afeez-adebayo/ author_x: https://x.com/za_icon source: https://afeezadebayo.com/skills-md/marketing/content-seo/topical-map/ category: marketing subcategory: content-seo version: "1.0.0" created: "2026-10-10" updated: "2026-10-10" --- # Topical Maps and Content Clusters A topical map is a plan of every page a site needs to cover a subject properly, how those pages relate to each other and in what order to publish them. It turns a keyword list into a structure: a hub that covers the topic broadly, clusters that cover each subtopic, and links that tie them together. This skill builds the map from the business outward, so the site becomes the obvious source on the topics it sells, rather than a pile of loosely related posts. ## Operating principles 1. **Business first.** Topics are chosen because they lead to the product, service or audience the business serves. 2. **One page, one intent.** Each node in the map answers one main need; overlapping nodes are merged before anything is written. 3. **Cover the topic, not the keyword list.** Include the subtopics a knowledgeable reader expects, even when tools show low volume. 4. **Links are part of the plan.** Every page knows its parent, siblings and children before it is written. 5. **Depth before breadth.** Finish a cluster before starting the next; a half-covered topic signals little. ## When to use, and when not to Use it for new sites and sections, resource centres, blog resets, entering a new product area, and when an existing blog has no structure. Don't use it for one-off pages (`content-brief`), for the link mechanics of an existing site (the Technical SEO internal linking skill) or for listing keywords without structure (`keyword-research`). ## Inputs to ask for, in one message 1. The business, its products or services, audience and markets. 2. The topic or topics to map, and how they connect to revenue. 3. Keyword research or Search Console data, if available. 4. A list of existing pages with URLs, titles and main queries. 5. Competitors seen as authorities on the topic. 6. Publishing capacity per month and any deadlines. ## Workflow ### Step 1. Define the core Write one sentence: the topic, the audience and why the business is credible on it. List the main entities: products, concepts, tools, people, standards and problems that belong to the topic. ### Step 2. Break the topic down | Level | Role | Example (topic: payroll for small businesses) | |---|---|---| | Pillar or hub | Broad guide or landing page for the whole topic | Payroll for small businesses | | Cluster | A subtopic with its own set of queries | Payroll taxes, running payroll, payroll software, compliance | | Supporting page | One specific question, task or comparison | How to calculate employer national insurance; best payroll software for under 10 staff | Sources for subtopics: People also ask, related searches, competitor navigation, textbooks and standards, customer questions, keyword clusters. ### Step 3. Assign intent and format For each node: main query, intent, content type (guide, comparison, template, tool, glossary entry, product page) and the funnel stage it serves. ### Step 4. Map existing content Match existing URLs to nodes. Mark each node: covered well, covered weakly (needs a refresh), split across pages (needs merging) or missing. ### Step 5. Plan links Every supporting page links up to its cluster page and pillar; cluster pages link down to all their supporting pages and across to related clusters; commercial pages are linked from the guides that lead to them, with descriptive anchors. ### Step 6. Prioritise and sequence Score nodes on business value, demand, current position and effort. Publish in cluster batches: the cluster page plus its most valuable supporting pages first, then fill in. ### Step 7. Set review points After each batch, check impressions and rankings for the cluster in Search Console after 8 to 12 weeks, and adjust the next batch. ## Topical authority, plainly Google has not published a "topical authority" score. In practice, sites that cover a subject thoroughly, accurately and with first-hand expertise tend to rank more pages on that subject and earn more links. Treat the map as a way to be useful and complete, not as a formula. ## Worked example A cross-border payments company wanted to rank for international money transfer topics. The map defined one hub (sending money abroad), six clusters (fees and exchange rates, transfer times, safety and regulation, methods, country corridors and business payments) and 74 supporting pages. Mapping existing content found 19 pages covering 23 nodes, 4 pairs that overlapped and 51 missing nodes. The first quarter shipped the fees cluster and the 10 highest-value corridor pages, all linked to the relevant product pages. ## Output format ``` # Topical map: <topic>, <business>, <date> ## Core statement and entities ## Map | Level | Node | Main query | Intent | Format | Parent | Existing URL | Status | Priority | ## Link plan (parents, siblings, commercial links) ## Publishing sequence by batch, with review dates ``` ## Sizing the map | Site situation | Typical scope | Advice | |---|---|---| | New site, small team | 1 pillar, 3 to 5 clusters, 20 to 40 pages | Finish one cluster before starting the next | | Established blog without structure | Map existing posts first | Merges and refreshes often beat new pages | | Large resource centre | Several pillars | Assign an owner per pillar | | Programmatic sections | Templates as nodes | Map templates and their index pages, not every URL | ## Map maintenance | Trigger | Action | |---|---| | New product or feature | Add a cluster or nodes linked to the product page | | Node page published | Update its status and add planned links from parent and siblings | | Node underperforms after six months | Check intent, depth and links before adding more nodes | | Two nodes start competing | Merge them and redirect | | Quarterly review | Re-check demand, competitors and the publishing sequence | Keep the map in a shared sheet or tool with columns for node, intent, parent, target URL, status, owner and last review date. ## Edge cases and judgement calls | Situation | What to do | |---|---| | A topic leads to no product | Keep it only if it builds trust with the right audience; otherwise drop it | | Two nodes share most results | Merge them into one page | | Competitors cover a subtopic you can't speak to credibly | Leave it out or partner with an expert; thin coverage hurts trust | | Regulated topics (finance, health, legal) | Plan expert review into the sequence and budget | | Product pages and guides overlap | Give guides the learning intent and link to product pages for buying intent | ## Handoffs to related skills - Demand and clusters: `keyword-research` - Intent for each node: `search-intent-serp-analysis` - Briefs for each page: `content-brief` - Overlaps between existing pages: `keyword-cannibalisation` - Weak existing pages: `content-refresh` - Implementing links on the live site: the Technical SEO `internal-linking` skill - Conversational questions for AI search: the AEO & GEO `query-fan-out-mapping` skill ## Quality bar: what an excellent map includes - A core statement that ties the topic to the business. - One intent and one parent per node, with existing pages mapped. - A link plan written before writing starts. - A publishing sequence the team can actually deliver, with review dates. - Clear reasons for what was left out. ## Common mistakes - Mapping keywords instead of topics, creating a page for every variant. - Topics with no route to the product or audience. - Publishing scattered pages across many clusters at once. - Leaving out internal links until after publishing. - Treating a published map as finished; it changes as results change. ## Questions to ask before you recommend a map - Which topics lead to revenue, and which build trust earlier in the journey? - How many pages can the team publish and maintain each month? - What expertise and evidence can the business show on each cluster? ## Self-check before you answer - Does every node have one intent and one parent? - Is existing content mapped, with merges flagged? - Are links planned before writing starts? - Is the sequence realistic for the team's capacity? ## Official documentation - Creating helpful, reliable, people-first content: https://developers.google.com/search/docs/fundamentals/creating-helpful-content - SEO Starter Guide (organise your site): https://developers.google.com/search/docs/fundamentals/seo-starter-guide - Link best practices: https://developers.google.com/search/docs/crawling-indexing/links-crawlable --- Created by Afeez Adebayo, Marketing, SEO & Growth Expert Website: https://afeezadebayo.com LinkedIn: https://www.linkedin.com/in/afeez-adebayo/ X: https://x.com/za_icon Source: https://afeezadebayo.com/skills-md/marketing/content-seo/topical-map/ Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). You may copy, share and adapt this skill, including for commercial use, as long as you credit Afeez Adebayo and link to the source URL above. Keep this notice in any copy or adapted version.
Workflow
Step 1. Define the core
Write one sentence: the topic, the audience and why the business is credible on it. List the main entities: products, concepts, tools, people, standards and problems that belong to the topic.
Step 2. Break the topic down
| Level | Role | Example (topic: payroll for small businesses) |
|---|---|---|
| Pillar or hub | Broad guide or landing page for the whole topic | Payroll for small businesses |
| Cluster | A subtopic with its own set of queries | Payroll taxes, running payroll, payroll software, compliance |
| Supporting page | One specific question, task or comparison | How to calculate employer national insurance; best payroll software for under 10 staff |
Sources for subtopics: People also ask, related searches, competitor navigation, textbooks and standards, customer questions, keyword clusters.
Step 3. Assign intent and format
For each node: main query, intent, content type (guide, comparison, template, tool, glossary entry, product page) and the funnel stage it serves.
Step 4. Map existing content
Match existing URLs to nodes. Mark each node: covered well, covered weakly (needs a refresh), split across pages (needs merging) or missing.
Step 5. Plan links
Every supporting page links up to its cluster page and pillar; cluster pages link down to all their supporting pages and across to related clusters; commercial pages are linked from the guides that lead to them, with descriptive anchors.
Step 6. Prioritise and sequence
Score nodes on business value, demand, current position and effort. Publish in cluster batches: the cluster page plus its most valuable supporting pages first, then fill in.
Step 7. Set review points
After each batch, check impressions and rankings for the cluster in Search Console after 8 to 12 weeks, and adjust the next batch.
Topical authority, plainly
Google has not published a "topical authority" score. In practice, sites that cover a subject thoroughly, accurately and with first-hand expertise tend to rank more pages on that subject and earn more links. Treat the map as a way to be useful and complete, not as a formula.
Worked example
A cross-border payments company wanted to rank for international money transfer topics. The map defined one hub (sending money abroad), six clusters (fees and exchange rates, transfer times, safety and regulation, methods, country corridors and business payments) and 74 supporting pages. Mapping existing content found 19 pages covering 23 nodes, 4 pairs that overlapped and 51 missing nodes. The first quarter shipped the fees cluster and the 10 highest-value corridor pages, all linked to the relevant product pages.
Output format
# Topical map: <topic>, <business>, <date>
## Core statement and entities
## Map
| Level | Node | Main query | Intent | Format | Parent | Existing URL | Status | Priority |
## Link plan (parents, siblings, commercial links)
## Publishing sequence by batch, with review datesSizing the map
| Site situation | Typical scope | Advice |
|---|---|---|
| New site, small team | 1 pillar, 3 to 5 clusters, 20 to 40 pages | Finish one cluster before starting the next |
| Established blog without structure | Map existing posts first | Merges and refreshes often beat new pages |
| Large resource centre | Several pillars | Assign an owner per pillar |
| Programmatic sections | Templates as nodes | Map templates and their index pages, not every URL |
Map maintenance
| Trigger | Action |
|---|---|
| New product or feature | Add a cluster or nodes linked to the product page |
| Node page published | Update its status and add planned links from parent and siblings |
| Node underperforms after six months | Check intent, depth and links before adding more nodes |
| Two nodes start competing | Merge them and redirect |
| Quarterly review | Re-check demand, competitors and the publishing sequence |
Keep the map in a shared sheet or tool with columns for node, intent, parent, target URL, status, owner and last review date.
Edge cases and judgement calls
| Situation | What to do |
|---|---|
| A topic leads to no product | Keep it only if it builds trust with the right audience; otherwise drop it |
| Two nodes share most results | Merge them into one page |
| Competitors cover a subtopic you can't speak to credibly | Leave it out or partner with an expert; thin coverage hurts trust |
| Regulated topics (finance, health, legal) | Plan expert review into the sequence and budget |
| Product pages and guides overlap | Give guides the learning intent and link to product pages for buying intent |
Handoffs to related skills
- Demand and clusters:
keyword-research - Intent for each node:
search-intent-serp-analysis - Briefs for each page:
content-brief - Overlaps between existing pages:
keyword-cannibalisation - Weak existing pages:
content-refresh - Implementing links on the live site: the Technical SEO
internal-linkingskill - Conversational questions for AI search: the AEO & GEO
query-fan-out-mappingskill
Quality bar: what an excellent map includes
- A core statement that ties the topic to the business.
- One intent and one parent per node, with existing pages mapped.
- A link plan written before writing starts.
- A publishing sequence the team can actually deliver, with review dates.
- Clear reasons for what was left out.
Common mistakes
- Mapping keywords instead of topics, creating a page for every variant.
- Topics with no route to the product or audience.
- Publishing scattered pages across many clusters at once.
- Leaving out internal links until after publishing.
- Treating a published map as finished; it changes as results change.
Questions to ask before you recommend a map
- Which topics lead to revenue, and which build trust earlier in the journey?
- How many pages can the team publish and maintain each month?
- What expertise and evidence can the business show on each cluster?
Self-check before you answer
- Does every node have one intent and one parent?
- Is existing content mapped, with merges flagged?
- Are links planned before writing starts?
- Is the sequence realistic for the team's capacity?
Official documentation
- Creating helpful, reliable, people-first content: https://developers.google.com/search/docs/fundamentals/creating-helpful-content
- SEO Starter Guide (organise your site): https://developers.google.com/search/docs/fundamentals/seo-starter-guide
- Link best practices: https://developers.google.com/search/docs/crawling-indexing/links-crawlable
On this page
- When to use this skill, and when not to
- Example prompts
- Example output
- What the agent needs from you
- How this skill hands off to related skills
- How to run the Topical Maps skill step by step
- Situations this skill handles
- What makes this skill different
- Practical tips from real projects
- Frequently asked questions
- Changelog
When to use this skill, and when not to
Use it when you launch a new site or resource centre, reset a blog that grew without structure, move into a new product area, or want to become the obvious source on the topics you sell. It turns a keyword list into a plan with a clear job for every page.
Don’t use it for a single page (use SEO Content Briefs), for the link mechanics of an existing site (use Internal Linking and Site Architecture) or for raw keyword lists (use Keyword Research).
Example prompts
- “Build a topical map for international money transfers, mapped to our existing 19 pages.”
- “We sell HR software. Plan the clusters for our resource centre for the next six months.”
- “Turn this keyword research into a pillar and cluster structure.”
- “Which subtopics are we missing compared with the three sites Google treats as authorities?”
- “Sequence the map so we can publish eight pages a month.”
Example output
The skill returns a fixed structure. A shortened example for an imaginary site:
# Topical map: sending money abroad, 10 October 2026 ## Core Audience: individuals and SMEs sending money from the UK. Credibility: licensed payments provider. ## Map (extract) | Level | Node | Main query | Format | Existing URL | Status | Priority | | Pillar | Sending money abroad | send money abroad | Guide | /send-money/ | Weak | 1 | | Cluster | Fees and exchange rates | international transfer fees | Guide | none | Missing | 1 | | Support | Hidden FX markups explained | exchange rate markup | Explainer | /blog/fx-markup/ | Covered | 2 | ## Batch 1 (October) Fees cluster page + 6 supporting pages + 10 corridor pages.
Every node has one intent and one parent, existing pages are mapped before new ones are planned, and links are decided before writing starts.
What the agent needs from you
The skill asks for the business, its products, audience and markets, the topics that lead to revenue, keyword research or Search Console data, a list of existing pages with their main queries, competitors seen as authorities, and how many pages the team can publish and maintain each month.
How this skill hands off to related skills
The map sets the work for other skills. Demand data comes from Keyword Research, each node is checked with Search Intent and SERP Analysis and briefed with SEO Content Briefs. Overlapping existing pages go to Keyword Cannibalisation, weak ones to Content Refresh, and the link plan is implemented with Internal Linking and Site Architecture.
How to run the Topical Maps skill step by step
- Install the skill as
topical-map/SKILL.md. - Describe the business and the topics that lead to revenue.
- Share keyword research or Search Console data and a list of existing pages with their main queries.
- Name the competitors you see as authorities on the topic.
- Say how many pages the team can publish and maintain each month.
- Review the map, link plan and sequence, then brief the first batch.
Situations this skill handles
Topical maps fix different problems on different sites. The skill handles these cases:
| Situation | What the skill does |
|---|---|
| New site or resource centre | Builds a pillar, clusters and supporting pages with a realistic sequence |
| Blog with no structure | Maps existing posts first, flags merges and refreshes, then fills gaps |
| Entering a new product area | Plans clusters that lead to the new product pages |
| Overlapping existing pages | Merges nodes with the same intent before anything is written |
| Regulated topics | Builds expert review into the sequence |
| Programmatic sections | Maps templates and index pages rather than every URL |
What makes this skill different
Most topical maps are keyword lists drawn as trees. This skill starts from the business: which topics lead to customers, what the business can credibly say, and how pages link before they are written. Each node has one intent and one parent, existing pages are mapped first, and the sequence fits the team’s capacity.
It is also clear about topical authority. Google hasn’t published a topical authority score; the map is a way to be complete and useful, which tends to help a site rank more pages and earn more links on its subject.
Practical tips from real projects
- Depth before breadth. Finish a cluster before starting the next.
- Plan links before writing, so every page knows its parent, siblings and children.
- Map what exists first. Merges and refreshes often beat new pages.
- Leave out what you can’t do well. Thin coverage of a subtopic hurts trust.
A worked example: a cross-border payments company mapped one hub, six clusters and 74 supporting pages. Matching existing content found 19 pages covering 23 nodes, four overlapping pairs and 51 gaps. The first quarter shipped the fees cluster and the ten highest-value country corridor pages, each linked to the relevant product page, instead of scattering pages across every cluster.
The map also becomes the brief queue. Each node carries its main query, intent, format and links, so writers start from a plan rather than a keyword, and editors can check new pages against it to avoid overlap.
Revisit the map every quarter. Results shift, new questions appear and some clusters prove more valuable than expected, so the sequence should follow what the data shows.
When a team is small, the map also protects focus. It makes clear which ten pages matter this quarter and which can wait, so effort isn’t spread thinly across every possible topic. Saying no to low-value nodes is part of the plan, and the skill records the reasons for each decision.
Frequently asked questions
What is a topical map?
A plan of every page a site needs to cover a subject, how the pages relate as pillar, clusters and supporting pages, and the order to publish them. It turns keywords into a structure with one job per page.
Does topical authority exist?
Google hasn’t published a topical authority score. In practice, sites that cover a subject thoroughly and accurately tend to rank more pages on it and earn more links. The skill treats the map as a way to be complete and useful, not a formula.
How many pages should a cluster have?
As many as the subtopic needs to answer readers’ real questions, often between five and twenty. The skill adds nodes from customer questions and results, not to hit a number.
Should I publish everything at once?
No. Finish one cluster before starting the next, so links and coverage build together and you can measure what works.
How do topical maps relate to internal links?
The map decides which pages link to which; the internal linking skill implements and checks those links on the live site.
Changelog
- 1.0.0, 10 October 2026: first release.
Use, adapt and share this skill under CC BY 4.0: credit Afeez Adebayo and link to this page.
All Content and On-Page SEO skills
