skills.rest
christian-byrne
christian-byrneCOMMUNITY
Explore all skills by this author →
𝕏@c__byrneGitHub

site-architecture

Plans website page hierarchy, navigation, URL patterns, and internal linking structures.

Updated Jul 28, 2026
Search Tags:#internal linking#information architecture#sitemap#seo#website planning#navigation design#url structure
One-click install
npx skills add https://github.com/christian-byrne/comfy-skills --skill site-architecture-christian-byrne
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/christian-byrne/comfy-skills/tree/main/skills/site-architecture
Command: npx skills add https://github.com/christian-byrne/comfy-skills --skill site-architecture-christian-byrne

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, URLs become inconsistent, and users and search engines struggle to find content. This Skill guides the design of page hierarchy, navigation, URL patterns, and internal linking so a site is intuitive for users and optimized for search. ## Core Features & Use Cases - Page Hierarchy Design: Produces ASCII tree sitemaps and Mermaid visual sitemaps with navigation zones, applying the 3-click rule and flat-vs-deep tradeoffs. - Navigation & URL Specs: Defines header/footer/sidebar navigation, breadcrumbs, and consistent URL patterns per page type (features, blog, docs, integrations). - Internal Linking Plans: Builds hub-and-spoke linking models, orphan page audits, and cross-section link recommendations. - Use Case: A SaaS company restructuring its marketing site can get a full deliverable set — ASCII hierarchy, Mermaid sitemap, URL map table, navigation spec, and internal linking plan — tailored to its site type and existing URLs that need redirects. ## Quick Start Plan the site architecture for my SaaS marketing website, including the page hierarchy, URL structure, navigation, and internal linking plan.

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

Start from your site type (SaaS, blog, e-commerce, docs) and keep important pages within 3 clicks of the homepage. Organize pages into L0-L3 levels, produce an ASCII tree with URLs at each node, and ensure the URL path mirrors the hierarchy.

What URL structure should I use for a SaaS website?▼

Use readable, lowercase, hyphenated slugs that reflect the hierarchy, such as /features/analytics, /pricing, and /blog/post-slug. Avoid dates, IDs, and query parameters in URLs, and enforce a consistent trailing slash policy.

How many items should a website header navigation have?▼

Keep the primary header navigation to 4-7 items to avoid decision paralysis, with the logo linking home on the left and a CTA button rightmost. Order items by priority and limit mega menus to 3-4 columns.

How do I handle old URLs when restructuring a website?▼

Every old URL needs a 301 redirect to its new location before launch. Without redirects you lose backlink equity and create broken pages for anyone with bookmarked or linked old URLs.

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

A hub page (like a comprehensive SEO guide) links out to related spoke pages, and each spoke links back to the hub and to sibling spokes where relevant. This concentrates internal link equity on important pages and prevents orphan pages.

Related Skills

Explore More Marketing & Sales Skills→
nicoreincarnate-ossnicoreincarnate-oss

site-architecture

Generates ASCII page hierarchies, Mermaid visual sitemaps, URL maps, nav specs, linking plans, and redirect guidance for websites.

Community
Intermediate
apexradiusapexradius

redirect-audit

Detect indexed 404 URLs and generate redirect entries post-CMS migration.

Official
Intermediate
JDMAXiliusJDMAXilius

site-architecture

Audit website information architecture for crawlability and link equity.

Community
Advanced
htafollahtafolla
5

seo-programmatic

Automate programmatic SEO planning and analysis for data-driven pages.

Community
Advanced