site-architecture

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

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

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 become 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 following the 3-click rule, with templates for SaaS, e-commerce, blog, documentation, and small business sites. - Navigation & URL Planning: Define header nav (4-7 items), footer columns, breadcrumbs, and consistent human-readable URL patterns with redirect guidance. - Internal Linking Strategy: Create hub-and-spoke content models, visual Mermaid sitemaps, and link audit checklists to eliminate orphan pages. - Use Case: You are launching a SaaS marketing site and need to decide what pages to build, how the nav should be organized, and what URLs to use. This Skill produces a full page hierarchy, Mermaid sitemap, URL map table, and internal linking plan. ## Quick Start Ask the AI to plan a site architecture for your website, describing your site type, main audiences, and the most important pages you need.

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 structure and sitemap?▼

Start by identifying your site type, top business goals, and most important pages, then build a page hierarchy keeping key pages within 3 clicks of the homepage. Document it as an ASCII tree or Mermaid diagram with URLs at each node, plus a navigation spec and URL map table.

What is the best URL structure for SEO?▼

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

How many items should be in a website navigation menu?▼

Keep the primary header navigation to 4-7 items to avoid decision paralysis, with the call-to-action button rightmost and the logo linking home on the left. Group remaining links into organized footer columns and use dropdowns or sidebar nav for sub-pages.

What is the difference between a visual sitemap and an XML sitemap?▼

A visual sitemap is a planning diagram showing page hierarchy and navigation relationships, which is what this Skill produces. An XML sitemap is a machine-readable file for search engine crawlers and falls under technical SEO, not information architecture planning.

How do I fix orphan pages on my website?▼

Audit your site to find pages with no inbound internal links, then add contextual links from related content, include them in navigation or breadcrumbs, and connect them through hub-and-spoke clusters. Every page should have at least one internal link pointing to it.