site-architecture

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

Updated Aug 3, 2026
One-click install
npx skills add https://github.com/Yvesdefaria/GymLab --skill site-architecture-yvesdefaria
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/Yvesdefaria/GymLab/tree/main/.opencode/skills/site-architecture
Command: npx skills add https://github.com/Yvesdefaria/GymLab --skill site-architecture-yvesdefaria

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 structures, and internal linking plans that work for both users and search engines. ## Core Features & Use Cases - Page Hierarchy Design: Applies the 3-click rule and flat-vs-deep tradeoffs to produce ASCII tree sitemaps and Mermaid visual sitemaps with navigation zones. - Navigation & URL Planning: Delivers header/footer/sidebar navigation specs, breadcrumb formats, and consistent URL patterns per page type (features, blog, docs, comparisons, integrations). - Internal Linking Strategy: Builds hub-and-spoke content models, orphan page audits, and cross-section linking plans. - 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 hub-and-spoke internal linking model. ## 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 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, keep the hierarchy as flat as navigation allows, and document the result as an ASCII tree or Mermaid sitemap with URLs at each node.

What is the best URL structure for a SaaS website?

Use short, lowercase, hyphenated paths that mirror the hierarchy, such as /features/analytics, /blog/post-slug, and /docs/api/authentication. Avoid dates in blog URLs, IDs, query parameters, and deep nesting, and enforce a consistent trailing slash policy with 301 redirects for any changed URLs.

How many items should a website header navigation have?

Keep the primary header navigation to 4-7 items, ordered by priority, with the logo linking home on the left and a CTA button rightmost. If a section has many sub-pages, use a dropdown or mega menu limited to 3-4 columns rather than adding more top-level items.

Does this skill handle XML sitemaps and crawl errors?

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

How should programmatic SEO pages fit into site architecture?

Place scaled page sets like integrations or comparisons under hub pages such as /integrations or /compare, and keep them out of the main navigation. Use a hub-and-spoke internal linking model where each spoke links back to its hub, and account for crawl budget when adding hundreds of pages.