MCPInstall

pillar-content-architecture

How to design a content hub that earns topical authority. Pillar topic selection, cluster planning, internal linking architecture, URL structure, pillar and cluster page anatomy, topical authority signals for SEO and AEO/GEO, and the maintenance discipline that distinguishes intentional hubs from accidental orphans. Triggers on pillar content, content hub, topic cluster, topical authority, content architecture, hub and spoke, pillar page, cluster page, content silo, internal linking strategy. Also triggers when a content set is not ranking despite individual piece quality, when a pillar was launched without a cluster, or when content has accumulated without an architecture.

Installs
284
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/rampstackco/claude-skills --skill pillar-content-architecture
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads pillar-content-architecture automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Pillar Content Architecture

A senior content architect's playbook for designing content hubs that earn topical authority.

Most content programs accumulate accidentally. Pieces ship one at a time, internal linking happens (or does not) in editing, similar topics get covered by multiple pieces with no coordination, and six months later the team has a content set that looks like a sitemap but feels like a yard sale. Search engines see disconnected pages; AI engines see scattered citations; readers cannot tell which piece is the entry point and which is the reference.

This skill is the discipline of intentional hub architecture. It assumes you have decided which topic areas to invest in (see content-strategy) and have keyword data (see seo-keyword). It does not write any individual piece (see content-brief-authoring for per-piece work and content-and-copy for execution). What it does is design the structure: which topic gets a pillar, which subtopics get cluster pieces, how the pieces link to each other, where they live in the URL hierarchy, and what topical authority signals the architecture is engineered to produce.

When to use this skill: launching a new content hub, restructuring an existing content set into a hub, deciding whether a piece should be a pillar or a cluster, or auditing why a content area is not ranking despite individual piece quality.


What this skill is for

This skill spans hub-level content architecture. It composes with five sister and adjacent skills, and the distinction between them is what keeps each one sharp.

  • content-strategy is program-scope: multiple topic pillars, editorial calendar, governance, formats. Decides what topic areas to invest in across a quarter or year.
  • seo-keyword is upstream-input: keyword research that surfaces candidate pillar topics with volume, difficulty, and intent data.
  • This skill is hub-scope: one pillar plus its cluster, the architecture that ties them together. The structural decisions, not the per-piece content.
  • content-brief-authoring is per-piece scope: brief for one content artifact. Each cluster piece (and the pillar itself) gets briefed via that skill.
  • content-and-copy is execution scope: writing the piece itself.
  • seo-content-gap-audit is audit-side: finds missing pieces in an existing content set after the fact. This skill prevents the gaps; that skill catches the ones that emerge.

The clean composition: content-strategy decides which topics, seo-keyword surfaces opportunities, this skill designs the hub, content-brief-authoring briefs each piece, content-and-copy writes each piece, seo-content-gap-audit later catches what slipped. Six skills, sequential.

The audience: SEO content strategists, content architects, in-house teams designing content hubs, agencies running topical authority programs. The voice is senior content architect to junior content marketer. Concrete, opinionated, honest about what makes a hub earn authority versus decorate the sitemap.


Pillar vs cluster vs orphan content

The keystone distinction. Three categories of content in any program.

Pillar. Comprehensive piece covering a major topic area. 2,500 to 5,000 words plus. Anchors the topical authority claim for the topic. Receives links from cluster pieces; links out to cluster pieces selectively, not as a footer dump. The pillar is the entry point for the topic and the reference the cluster orbits.

Cluster. Narrower piece covering a specific facet of the pillar topic. 800 to 2,000 words. Links up to pillar; may link sideways to other clusters in the same hub when a connection is natural. Each cluster answers one specific question within the pillar's scope.

Orphan. Piece that does not connect to a pillar or cluster. May rank or convert on its own merits, but does not compound into topical authority. Some orphans are fine by design (release-note pages, customer stories, one-off campaigns); most orphans are accidents.

The pathology. Most content programs are 80% orphans, 15% accidental clusters, 5% accidental pillars. The discipline is moving toward 70% intentional clusters, 20% intentional pillars, 10% standalone-by-design. Same total content volume; different architectural outcome.

The reading model. Search engines and AI engines both read internal-link graphs to infer topical authority. A pillar with 12 well-linked cluster pieces signals depth on a topic. 12 orphans on the same topic signal scattered, less-authoritative coverage. The architecture is the signal.

Detail and decision tree in references/pillar-cluster-decision.md.


Topic selection for pillar pages

Not every topic deserves a pillar. The five-criterion selection framework:

  1. Search volume justifies the investment. Pillar topic has enough monthly volume to support a 3,000 to 5,000-word effort plus 8 to 15 cluster pieces. Sub-100 monthly searches usually does not.
  2. Topic has natural facets. You can identify 8 to 15 distinct subtopics that could each be their own piece. If you can only think of 3, it is probably a cluster, not a pillar.
  3. Commercial relevance. The topic connects to your business model. A pillar without commercial signal is content marketing for content marketing's sake.
  4. Competitive feasibility. Top 10 SERP for the pillar keyword is achievable. If the SERP is dominated by Wikipedia, government sites, and Fortune 500 brands, your pillar will rank position 47 no matter how good it is.
  5. Editorial commitment. The team will maintain the pillar (refresh annually, add new clusters, update statistics). Pillars are not ship-and-forget; they are 5-year commitments.

The "everything is a pillar" anti-pattern. Teams call any 3,000-word piece a pillar. Length does not make a pillar. The architecture does. Pillar is the role a piece plays in the hub structure, not the word count.

Detail in references/topic-selection-criteria.md.


Cluster planning

Once a pillar is selected, plan its cluster:

  1. Cluster size. Typically 8 to 15 pieces for a strong hub. Below 5 reads thin; above 25 becomes unmanageable; sweet spot is 10 to 12.
  2. Cluster facets. Each cluster piece covers one facet of the pillar topic. Facets are surfaced from keyword research (long-tail variations of pillar keyword), "people also ask" data, sub-headings in top-ranking pillar pages on the SERP, competitor cluster maps, and first-party customer questions (sales calls, support tickets).
  3. No facet duplication. Two cluster pieces should not target overlapping queries. If they do, consolidate to one piece.
  4. Cluster heterogeneity. Clusters should cover the topic from multiple angles (definition, how-to, comparison, examples, common mistakes, costs, alternatives, case studies) rather than 12 variations of "what is X."
  5. Sequence. Ship pillar first (or alongside the first 3 to 5 clusters). The link graph will not form without the pillar in place; clusters that link to a non-existent pillar are orphans-in-waiting.

Detail in references/cluster-planning-patterns.md.


Internal linking architecture

The hub's internal-link graph is what actually produces topical authority signals. The architecture has three directions:

Pillar to cluster (top-down). Pillar links out to each cluster piece via contextual anchors, typically once per cluster from within the pillar's body. Do not bury cluster links in a "related reading" footer; weave them into the relevant section of the pillar where the reader's curiosity peaks.

Cluster to pillar (bottom-up). Every cluster piece links up to the pillar at least once, typically in the first 200 words and again in the closing section. Bottom-up is the discipline that makes the pillar compound; without it the pillar is just a long article.

Cluster to cluster (lateral). Selective lateral linking when one cluster naturally references another. Do not force lateral links; an "everyone links to everyone" cluster is messy and dilutes anchor text relevance.

Anchor text discipline. Vary the anchor text. "Click here" is dead; exact-match keyword stuffing is dead; descriptive natural-language anchors are alive. The brief for each piece (see content-brief-authoring) specifies anchor text per outbound link.

The "linking inventory" pattern. Maintain a sheet (or database row, or dbt model) tracking every link in the hub, who links to whom, and the anchor text used. Audit quarterly to catch broken links, anchor-text drift, and missing connections that should exist.

Detail in references/internal-linking-architecture.md.


URL structure and information architecture

URL patterns matter for both crawl clarity and reader navigation. Decision factors:

Subfolder vs subdomain. Subfolder is the default (example.com/hub-topic/cluster-piece) for SEO consolidation; both pillar and cluster live on the same domain authority. Subdomain is appropriate only for genuinely distinct properties (docs.example.com, community.example.com).

Hub URL pattern. /hub-topic/ for the pillar, /hub-topic/cluster-piece/ for clusters. Avoid /blog/cluster-piece/ if the goal is hub authority; the URL itself signals topical grouping to crawlers and readers.

Slug conventions. Short, descriptive, keyword-aware but not stuffed. /seo-content-strategy/keyword-research-for-pillars/ not /the-ultimate-guide-to-seo-content-strategy-keyword-research-for-pillar-pages-2026/.

Breadcrumbs. Surface the hub structure in breadcrumb navigation. Helps readers see where they are; helps crawlers see the hierarchy.

The "/blog/ trap." Teams put pillar and clusters under /blog/ because that is where the CMS folder is. This works structurally but loses the URL signal that says "these pieces belong together as a topical hub."

Detail in references/url-structure-patterns.md.


Pillar page anatomy

A pillar page does specific work. The standard sections:

  • Hero. Defines the topic, signals scope ("The complete guide to X for Y audience"), establishes authority quickly.
  • TL;DR or executive summary. 150 to 250 words at the top. AI engines often cite this section verbatim. Treat it as the citation-ready summary, not as a marketing intro.
  • Comprehensive body. Covers the topic's major facets, with internal-link callouts to cluster pieces for deep dives. The body is not a comprehensive treatment of every facet; it is a guided tour with depth links.
  • Use cases or examples. Anchor the abstract topic to concrete instances.
  • Common mistakes / FAQ. AI-citation friendly section with structured Q&A. Pair with FAQ schema markup.
  • Closing or next steps. Directs reader into the cluster (which piece to read next based on intent).
  • Schema markup. Article or HowTo schema depending on intent; FAQPage schema for the FAQ section.

Pillar length. 3,000 to 5,000 words is the typical range. Pillar quality is comprehensiveness AND depth, not just word count. A 6,000-word pillar that covers 3 facets is worse than a 4,000-word pillar that covers 12 facets.

Detail in references/pillar-page-anatomy.md.


Cluster piece anatomy

Cluster pieces have a different shape:

  • Hero. Focused on one specific question or task, not broad.
  • Pillar callout. Link up to pillar in the first 200 words. Typical phrasing: "This piece covers X. For the broader context on Y, see our guide to [pillar topic]."
  • Focused body. Answers the specific question with depth, but does not expand into adjacent facets (those have their own cluster pieces).
  • Lateral callouts (selective). When relevant, link to 1 or 2 sibling cluster pieces.
  • Closing. Link back to pillar OR to the next logical cluster piece in a reader journey.

Cluster length. 800 to 2,000 words typical. A cluster piece longer than 2,500 words is probably a mini-pillar that should either get promoted to its own pillar or be split into two cluster pieces.

Detail in references/cluster-piece-anatomy.md.


Topical authority signals

Signals that make hub architecture compound into authority. The two-engine view: pillars and clusters serve search engines and answer engines together, not as competing optimizations.

SEO signals:

  • Internal-link graph density on the topic (PageRank flow within the hub)
  • Comprehensive entity coverage across pillar plus clusters (mentioned entities, statistics, citations)
  • URL structure clarity
  • Breadcrumb hierarchy
  • Schema markup (Article, HowTo, FAQPage as appropriate)
  • E-E-A-T signals: author credentials, expertise demonstrated, trust signals on every piece

AEO and GEO signals:

  • Answer-paragraph format directly under H2 headings (40 to 60 words, citation-ready)
  • TL;DR section on pillars (highly citable; AI engines extract it verbatim)
  • FAQ schema (still cited heavily by AI engines including Perplexity and ChatGPT)
  • Specific statistics with cited sources
  • Named experts and named methods (entities AI engines weight heavily for citation)
  • Distinctive POV that AI engines can attribute to your brand

The two-engine optimization is complementary, not competing. Both reward depth, structure, and entity coverage. The hub architecture creates more surface area for both signal types than scattered orphan content can.

Detail in references/topical-authority-signals.md and the seo-aeo-geo skill for AEO/GEO strategy at the program level.


Maintenance and refresh patterns

Hubs decay if not maintained. The discipline:

  • Annual pillar refresh. Every 12 months, audit the pillar against current SERP, update statistics, add new sections for emerged facets, prune sections that no longer matter, refresh internal-link callouts to cluster pieces (since the cluster has likely grown).
  • Cluster refresh as triggered. Clusters refresh when keyword performance drops, when a new sub-topic emerges, or when a cluster's links go stale.
  • Cluster expansion. Add new cluster pieces as the topic surfaces new facets. A hub at year 1 might have 8 clusters; year 3 could have 18.
  • Cluster pruning. Kill cluster pieces that fail to rank or get cited after 12 months. Redirect to the most-relevant remaining cluster or to the pillar. Pruning is not failure; it is hygiene.
  • Hub lifecycle. Hubs themselves have a lifespan. After 5 to 7 years, even mature hubs may need wholesale restructuring as the topic landscape shifts.

The "set and forget" failure. Hub launches, ranks, drives traffic for 2 years, then decays without anyone noticing because nobody owns the hub long-term. Hub ownership is durable: single owner across 3 to 5 year horizons, not "the team that launched it."

Detail in references/content-refresh-patterns.md.


Common failure modes

Rapid-fire. Diagnoses in references/common-pillar-failures.md.

  • "We have 80 blog posts but no rankings." Orphan content; no hub architecture.
  • "Our 8,000-word pillar does not rank." Comprehensive but no cluster support; pillar without a hub is just a long article.
  • "We launched the pillar, never built the cluster." Architecture half-built signals nothing.
  • "Cluster pieces do not link to the pillar." Top-down link graph but no bottom-up; the pillar does not compound.
  • "Two cluster pieces target the same keyword." Self-cannibalization; consolidate.
  • "Pillar URL is /blog/the-ultimate-guide-to..." Losing the URL hub signal.
  • "Our pillar is 12 sections of 'what is X'." Facet homogeneity; covers one angle 12 ways.
  • "We cannot tell which piece to refresh first." No maintenance ownership; no signals being tracked.
  • "Pillar ranks but does not get cited by AI engines." Missing AEO/GEO signals (no TL;DR, no answer paragraphs, no FAQ schema).
  • "Hub launched 3 years ago; nobody owns it now." Lifecycle ownership gap.
  • "We have 25 clusters and it is chaos." Over-built; sweet spot was 12.

The framework: 12 considerations for hub architecture

When designing or auditing a content hub, walk these 12 considerations.

  1. Topic earns the pillar. Search volume, facet count, commercial relevance, competitive feasibility, editorial commitment.
  2. Cluster size targets 10 to 12. Sweet spot, not the maximum.
  3. Facet heterogeneity. Definition, how-to, comparison, examples, mistakes, costs, alternatives. Not 12 variations of "what is X."
  4. No facet duplication. Clusters cover distinct queries; consolidate when they overlap.
  5. Pillar to cluster to pillar link graph. Top-down plus bottom-up plus selective lateral.
  6. Anchor text discipline. Varied, descriptive, natural-language. No stuffing, no "click here."
  7. URL structure signals the hub. /topic/ not /blog/.
  8. Pillar anatomy includes TL;DR and FAQ. Citation-ready sections for AI engines.
  9. Cluster anatomy links UP to pillar early. First 200 words and closing.
  10. AEO/GEO and SEO together. Two-engine optimization, complementary not competing.
  11. Annual pillar refresh plus triggered cluster refresh. Maintenance is part of the architecture.
  12. Hub ownership is durable. Single owner across 3 to 5 year horizons; not "the team that launched it."

The output of the framework is an architecture document the team can reference at every stage: pillar selected, cluster planned, links specified, URLs chosen, page anatomies templated, refresh cadence set, owner named.


If required data is unavailable

This skill's output depends on data, measurements, or tool results it cannot generate on its own. When a required input, tool, or data source is unavailable or unverifiable, the sanctioned output is the deliverable with the gap stated: what was needed, what was actually obtained or verified, and which parts of the output are affected. Fabricating, estimating, or interpolating a required number to complete the deliverable is never sanctioned. A stated gap is a complete answer.


Reference files

  • references/pillar-cluster-decision.md - Pillar vs cluster vs orphan decision tree with worked examples and the "everything is a pillar" anti-pattern.
  • references/topic-selection-criteria.md - Five-criterion framework expanded with B2B SaaS, ecommerce, services, and media examples.
  • references/cluster-planning-patterns.md - Facet sourcing methods, sequencing patterns, heterogeneity check.
  • references/internal-linking-architecture.md - Top-down, bottom-up, lateral patterns; anchor text discipline; linking inventory; quarterly audit checklist.
  • references/url-structure-patterns.md - Subfolder vs subdomain decision; slug conventions; breadcrumbs; the /blog/ trap.
  • references/pillar-page-anatomy.md - Section-by-section anatomy; TL;DR placement; FAQ schema; internal-link callouts; schema choices; length calibration.
  • references/cluster-piece-anatomy.md - Focused-question framing; pillar callout placement; lateral linking judgment.
  • references/topical-authority-signals.md - SEO and AEO/GEO signals at hub level; two-engine optimization framing.
  • references/content-refresh-patterns.md - Annual pillar refresh; triggered cluster refresh; cluster expansion and pruning; hub lifecycle.
  • references/common-pillar-failures.md - Eleven-plus failure patterns with diagnoses and fixes.

Closing: architecture is the moat

Comprehensive content can be replicated. Authoritative sources can be cited. Individual pieces can be matched in quality by competitors with similar resources. What is harder to replicate is the compounding of an intentional hub built and maintained over years: the link graph, the entity coverage, the maintenance discipline, the topical depth signals that build over a 3 to 5 year horizon.

That is the moat. Architecture is the only part of content marketing that compounds reliably; everything else is execution that can be matched.

When in doubt about whether a hub is ready, ask: is the pillar selected against the five criteria, are the 10 to 12 clusters planned with facet heterogeneity, is the link graph specified top-down and bottom-up, is the URL structure clean, is the pillar anatomy templated with TL;DR and FAQ, is the refresh cadence set, and is the durable owner named? If yes to all of those, ship the hub plan and let the per-piece briefs and writers work.

FAQ

What does the pillar-content-architecture skill do?

How to design a content hub that earns topical authority. Pillar topic selection, cluster planning, internal linking architecture, URL structure, pillar and cluster page anatomy, topical authority signals for SEO and AEO/GEO, and the maintenance discipline that distinguishes intentional hubs from accidental orphans. Triggers on pillar content, content hub, topic cluster, topical authority, content architecture, hub and spoke, pillar page, cluster page, content silo, internal linking strategy. Also triggers when a content set is not ranking despite individual piece quality, when a pillar was launched without a cluster, or when content has accumulated without an architecture.

How do I install pillar-content-architecture?

Run npx skills add https://github.com/rampstackco/claude-skills --skill pillar-content-architecture in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/pillar-content-architecture/ (personal) or .claude/skills/pillar-content-architecture/ (project).

Which AI agents can use pillar-content-architecture?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is pillar-content-architecture safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains pillar-content-architecture?

It is published by rampstackco in rampstackco/claude-skills. It has 284 recorded installs.

More from rampstackco/claude-skills

View all →

art-direction

rampstackco/claude-skills

Direct visual and creative work for campaigns, photography, illustration, video, and branded experiences. Use this skill whenever the user wants to brief a photographer, direct illustrators, plan a creative campaign, develop visual concepts, or evaluate creative work for fit. Triggers on art direction, photo brief, photography brief, illustration brief, campaign concept, creative concept, visual direction, mood board, look and feel, visual treatment, video direction. Also triggers when the user has approved brand identity but needs to extend it into specific creative deliverables. Use creative-direction instead when the ask is the project-wide aesthetic brief that this skill consumes as input.

Media & Creative676 installs

brand-identity

rampstackco/claude-skills

Design or evaluate a brand visual identity system covering logo, color, typography, imagery direction, iconography, and motion principles. Use this skill whenever the user wants to design a logo, build a visual identity, define brand colors, choose brand typography, develop iconography, plan brand imagery, or evaluate an existing identity for cohesion. Triggers on logo design, brand identity, visual identity, brand mark, wordmark, monogram, color palette, brand colors, brand typography, type system, iconography, brand imagery, motion design, brand system, identity system. Also triggers when the user has a brand direction approved and now needs the visual artifacts that express it.

Marketing & SEO500 installs

logo-design

rampstackco/claude-skills

Open the skill to read its SKILL.md instructions.

448 installs

creative-direction

rampstackco/claude-skills

Walk the user through four directional axes (tone register, aesthetic philosophy, audience relationship, sensory ambition) and produce a structured aesthetic brief that downstream content, copy, design, and art-direction skills consume as required input. The aesthetic depth layer, distinct from creative-brief (operational kickoff: scope, audience, deliverables, constraints). Use when a project needs aesthetic coherence across many small decisions and the user has only a vague feeling, or when multiple downstream aesthetic-producing skills need a shared brief. Triggers on creative direction, aesthetic direction, set the aesthetic, define the visual direction, what's the vibe, what's the tone, the four axes. Does NOT fire for a general kickoff brief (use creative-brief), tactical single-piece work, already-documented direction, purely functional output, or locked production-stage work.

Media & Creative421 installs

brand-style-guide

rampstackco/claude-skills

Build or audit a comprehensive brand style guide that documents the full brand system including story, logo system, color, typography, imagery, voice, applications, and dos/don'ts. Use this skill whenever the user wants to create brand guidelines, document an existing brand, build a brand book, audit an existing style guide for completeness, or produce the artifact that other teams will reference for years. Triggers on style guide, brand guidelines, brand book, brand standards, brand manual, style sheet, brand documentation, brand reference. Also triggers when the brand identity is finished and needs to be documented for handoff to designers, developers, vendors, or future team members.

Marketing & SEO393 installs

landing-page-copy

rampstackco/claude-skills

Write landing page copy with attention to the hero, value proposition, social proof, objection handling, and conversion-focused CTAs. Use this skill whenever the user wants to write a landing page, sales page, hero section, or any conversion-focused web copy. Triggers on landing page, sales page, hero copy, value proposition, headline, subheadline, hero section, CTA copy, conversion copy, opt-in page, squeeze page. Also triggers when the user has a marketing campaign or product launch needing dedicated conversion copy. Use cro-optimization instead when the page already exists and the ask is to lift its conversion rate through testing rather than to write the copy.

Marketing & SEO378 installs

Popular code quality & workflow skills

View category →

grill-me

mattpocock/skills

A relentless interview to sharpen a plan or design.

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

handoff

mattpocock/skills

Compact the current conversation into a handoff document for another agent to pick up.

domain-modeling

mattpocock/skills

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

codebase-design

mattpocock/skills

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

diagnosing-bugs

mattpocock/skills

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.