site-architecture

Plan website page hierarchies, navigation, URL structures, and internal linking strategies.

1|Updated Feb 1, 2025
One-click install
npx skills add https://github.com/TiagoDanin/TiagoDanin.github.io --skill site-architecture-tiagodanin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/TiagoDanin/TiagoDanin.github.io/tree/main/.claude/skills/seo/site-architecture
Command: npx skills add https://github.com/TiagoDanin/TiagoDanin.github.io --skill site-architecture-tiagodanin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Planning a website's structure is hard to get right: pages end up buried too deep, navigation confuses visitors, URLs are inconsistent, and orphan pages hurt SEO. This Skill guides you through designing a complete information architecture so users and search engines can find every important page. ## Core Features & Use Cases - Page Hierarchy Design: Build ASCII tree sitemaps and Mermaid visual sitemaps following the 3-click rule, with templates for SaaS, blog, e-commerce, docs, hybrid, and small business sites. - Navigation & URL Planning: Define header nav, mega menus, footers, sidebars, and breadcrumbs, plus consistent URL patterns with redirect guidance for restructures. - Internal Linking Strategy: Create hub-and-spoke content models, cross-section link plans, and orphan page audits. - Use Case: You are launching a SaaS product site and need to decide what pages exist, how the header nav is organized, what the URL patterns look like, and how blog posts link back to feature pages — this Skill produces the full plan as deliverables. ## Quick Start Plan the site architecture for my SaaS marketing website, including a page hierarchy, URL map, and header navigation.

Frequently Asked Questions about site-architecture

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

FAQPage Schema
How do I plan a website site structure and page hierarchy?

Start by identifying your site type, top business goals, and most important pages, then organize pages into a hierarchy where key content is reachable within 3 clicks. Use an ASCII tree or Mermaid diagram to map every page with its URL before building.

What is the best URL structure for SEO?

Use short, lowercase, hyphenated URLs that mirror the site hierarchy, such as /features/analytics or /blog/post-slug. Avoid dates, IDs, query parameters, and deep nesting, and always set up 301 redirects when changing existing URLs.

How many items should a website header navigation have?

Keep the primary header navigation to 4-7 items, ordered by priority, with the logo on the left linking home and a CTA button rightmost. If you have more pages, group them into dropdowns or a mega menu with at most 3-4 columns.

What is a hub-and-spoke internal linking model?

A hub-and-spoke model organizes content around a comprehensive hub page that links to related spoke articles, each of which links back to the hub. This concentrates internal link authority on the hub and helps search engines understand topic clusters.

When should I use a visual sitemap versus an XML sitemap?

Use a visual sitemap (ASCII tree or Mermaid diagram) when planning page hierarchy and navigation for humans. XML sitemaps are a technical SEO concern for search engine crawlers and are handled separately from information architecture planning.

How do I fix orphan pages on my website?

Audit the site to find pages with no inbound internal links, then add contextual links from related content, include them in navigation or footer sections, and connect them to relevant hub pages. Every page should have at least one internal link pointing to it.