site-architecture

Plan website page hierarchy, navigation, URL structure, and internal linking for SEO.

Updated Apr 1, 2026
One-click install
npx skills add https://github.com/yo16/cc_dev_team --skill site-architecture-yo16
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/yo16/cc_dev_team/tree/main/specific_set/seo/skills/site-architecture
Command: npx skills add https://github.com/yo16/cc_dev_team --skill site-architecture-yo16

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Planning or restructuring a website's information architecture is difficult: pages get buried, navigation becomes cluttered, URLs become inconsistent, and orphan pages hurt SEO. This Skill guides the design of page hierarchies, navigation systems, URL patterns, and internal linking so sites are intuitive for users and optimized for search engines. ## Core Features & Use Cases - Page Hierarchy Design: Applies the 3-click rule and flat-vs-deep tradeoffs to produce ASCII tree structures and Mermaid visual sitemaps with navigation zones. - URL Structure Planning: Provides URL patterns per page type (features, blog, docs, comparisons, integrations) with rules for redirects, slugs, and consistency. - Navigation & Internal Linking: Designs header, footer, sidebar, and breadcrumb navigation plus hub-and-spoke internal linking strategies with an orphan-page audit checklist. - Use Case: A SaaS team adding 200 programmatic integration pages and 50 comparison pages asks how they fit into the site; the Skill recommends hub pages, URL patterns, and linking without cluttering the main nav. ## Quick Start Ask the assistant to plan the site architecture for your website, describing your site type, main sections, and any existing pages that need reorganizing.

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 for SEO?▼

Start with a content inventory, then apply the 3-click rule so important pages sit within three levels of the homepage. Group pages into a logical hierarchy, keep URLs short and descriptive, and produce an ASCII tree or Mermaid sitemap to validate the structure.

What URL structure should I use for blog posts and feature pages?▼

Use short, readable, lowercase paths with hyphens such as /blog/post-slug and /features/feature-name. Avoid dates, IDs, query parameters, and deep nesting, and keep one consistent parent pattern per section.

How many items should a website header navigation have?▼

Keep the primary header navigation to 4-7 items with the CTA button rightmost. If sections grow beyond that, group pages into dropdowns or mega menus with at most 3-4 columns.

Does this skill fix XML sitemaps or crawl errors?▼

No. XML sitemaps, crawl errors, and indexation are technical SEO concerns handled by the seo-audit skill. This skill covers design-time architecture: page hierarchy, navigation, URL patterns, and internal linking.

How do I handle URLs when restructuring an existing website?▼

Map every old URL to its new location and implement 301 redirects before launch. Without redirects you lose backlink equity and create broken pages for anyone with old links or bookmarks.

What is hub-and-spoke internal linking?▼

A hub page covers a broad topic and links to detailed spoke pages, each of which links back to the hub and to related spokes. This concentrates authority on the hub and ensures no page becomes an orphan.