site-architecture

Plan website page hierarchy, navigation, URL patterns, and internal linking.

4|4|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/akp-alliance/npx-skills-add-coreyhaines31-marketingskills --skill site-architecture-akp-alliance
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/akp-alliance/npx-skills-add-coreyhaines31-marketingskills/tree/main/.claude/skills/site-architecture
Command: npx skills add https://github.com/akp-alliance/npx-skills-add-coreyhaines31-marketingskills --skill site-architecture-akp-alliance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves the challenge of figuring out how to organize a website’s pages so users can find what they need quickly and search engines can understand the site’s structure.

Core Features & Use Cases

  • Page hierarchy and information architecture planning: Draft a clear page hierarchy using principles like the 3-click rule and appropriate depth (flat vs. deep).
  • Navigation and URL structure design: Recommend header/footer/sidebar navigation patterns, breadcrumbs alignment, and consistent, readable URL patterns by page type.
  • Internal linking strategy for discoverability: Create hub-and-spoke linking plans to connect related content clusters (e.g., comparisons, integrations) and avoid orphan pages.
  • Deliverable outputs for implementation: Provide an ASCII tree hierarchy, a visual sitemap (Mermaid), a URL map table, and a navigation + linking specification.

Quick Start

Use the site-architecture skill to design your site hierarchy and URL patterns by telling it what pages you want and what kind of site you’re building.

Frequently Asked Questions about site-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is hub and spoke internal linking for site architecture?

Hub and spoke internal linking connects related content clusters to central topic pages, ensuring search engines discover grouped pages and avoiding orphan pages. This strategy enhances site findability by structuring internal links around thematic hubs within your site architecture.

How do I plan an SEO-friendly website structure for a new SaaS marketing site?

Plan an SEO-friendly website structure by defining page hierarchy, navigation design, and URL patterns using the 3-click rule. Produce deliverables like an ASCII hierarchy tree, Mermaid visual sitemap, and URL map to guide your SaaS marketing site implementation.

Can I use a Mermaid visual sitemap to document my information architecture?

Yes, generating a Mermaid visual sitemap is a core deliverable for documenting information architecture. It visually maps your page hierarchy and navigation design, making your site structure easy to understand and share with developers.

What is the best way to design URL structure for different page types?

The best way to design URL structure is to create a URL map table specifying consistent, readable URL patterns by page type. Aligning breadcrumbs and URL patterns with your page hierarchy improves both user findability and SEO structure.

Does this site architecture approach work for restructures of existing content sites?

Yes, this site architecture planning applies to both new builds and restructures of content sites. It defines updated page hierarchy, navigation, and internal linking strategies to improve SEO structure and user findability across scaled sections like integrations.

Why does my website hierarchy need a navigation specification and URL map?

A navigation specification and URL map are needed to translate your website hierarchy into actionable developer instructions. These structured deliverables ensure header, footer, and sidebar navigation patterns plus URL structures are implemented correctly.