site-architecture

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

Updated Jul 23, 2026
One-click install
npx skills add https://github.com/samuelgabrielsikorjak-sys/techscope-website --skill site-architecture-samuelgabrielsikorjak-sys
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/samuelgabrielsikorjak-sys/techscope-website/tree/main/.claude/skills/marketingskills-main/skills/site-architecture
Command: npx skills add https://github.com/samuelgabrielsikorjak-sys/techscope-website --skill site-architecture-samuelgabrielsikorjak-sys

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 internal linking is neglected. This Skill provides a structured methodology for designing page hierarchies, navigation systems, URL patterns, and internal linking plans that work for both users and search engines. ## Core Features & Use Cases - Page Hierarchy Design: Apply the 3-click rule and flat-vs-deep principles to build ASCII tree sitemaps and Mermaid visual sitemaps for any site type (SaaS, blog, e-commerce, docs, hybrid, small business). - URL Structure & Navigation Specs: Generate URL maps with consistent patterns, header/footer/sidebar navigation layouts, and breadcrumb implementations aligned to the hierarchy. - Internal Linking Strategy: Design hub-and-spoke content models, audit orphan pages, and plan cross-section links. - Use Case: A SaaS company adding 200 programmatic integration pages and 50 comparison pages asks how they fit into the site. The Skill recommends hub pages at /integrations and /compare, keeps them out of the main nav, and defines the hub-and-spoke linking model. ## Quick Start Ask the assistant to plan the site architecture for your website, describing your site type, main sections, and whether it is a new build or a restructure.

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 with a content inventory and business goals, then apply the 3-click rule so important pages sit within three levels of the homepage. Group pages into logical parent-child sections, document the result as an ASCII tree, and validate that navigation stays under 4-7 header items.

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

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

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 and a CTA button rightmost. If sections grow larger, group sub-pages into dropdowns or mega menus limited to 3-4 columns.

Does this skill fix XML sitemaps or crawl errors?

No. XML sitemaps, crawl errors, and indexation issues are technical SEO tasks handled by a dedicated seo-audit skill. This skill covers design-level 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 launching the new structure. Without redirects you lose backlink equity and create broken pages for anyone using old links or bookmarks.

What is hub-and-spoke internal linking?

Hub-and-spoke linking organizes content around a comprehensive hub page that links to related spoke articles, with each spoke linking back to the hub and cross-linking to sibling spokes. It concentrates authority on the hub and prevents orphan pages.