site-architecture

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

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/Transform24/THE-QUIET-AUTHORITY --skill site-architecture-transform24
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/Transform24/THE-QUIET-AUTHORITY/tree/main/content-ops/_factory/skills/site-architecture
Command: npx skills add https://github.com/Transform24/THE-QUIET-AUTHORITY --skill site-architecture-transform24

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 grow inconsistent, and internal linking is neglected. This Skill provides a structured methodology for designing 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 for any site type (SaaS, blog, e-commerce, docs, hybrid, small business). - URL Structure & Navigation Specs: Generates URL maps with consistent patterns, header/footer/sidebar navigation layouts, and breadcrumb implementations aligned to the hierarchy. - Internal Linking Strategy: Builds hub-and-spoke content models, cross-section link plans, and orphan page audits. - Use Case: A SaaS company adding 200 programmatic integration pages asks how they fit into the site. The Skill recommends hub pages at /integrations, keeps them out of the main nav, defines URL patterns, and maps the internal 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 stay within three levels of the homepage. Group pages into logical parent-child sections, document the result as an ASCII tree, and validate depth against your site type.

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 with the CTA button rightmost. If sections contain many pages, use dropdowns or mega menus with 2-4 columns rather than adding more top-level items.

Does this skill fix XML sitemaps and crawl errors?▼

No. XML sitemaps, crawl errors, and indexation issues are technical SEO tasks handled by a dedicated seo-audit skill. This skill covers information architecture design: page hierarchy, navigation, URL patterns, and internal linking.

How do I create a visual sitemap to share with a design team?▼

Use Mermaid graph TD diagrams showing pages as nodes and hierarchy as edges, with subgraphs for header and footer navigation zones. The references include copy-paste templates for basic hierarchies, hub-and-spoke models, and color-coded before/after restructuring diagrams.

How should programmatic SEO pages fit into site architecture?▼

Place scaled pages under hub pages like /integrations or /compare, keep them out of the main navigation, and use hub-and-spoke internal linking where each spoke links back to its hub. Consider crawl budget when adding hundreds of pages.