site-architecture

Plan website information architecture with page hierarchy, navigation, and URL structure.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/kekoesports/proyectozack --skill site-architecture-kekoesports
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/kekoesports/proyectozack/tree/main/.agents/skills/site-architecture
Command: npx skills add https://github.com/kekoesports/proyectozack --skill site-architecture-kekoesports

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan and optimize a website's information architecture by defining page hierarchy, navigation, and URL structure to improve usability and findability.

Core Features & Use Cases

  • Map pages and create logical hierarchies for SaaS marketing sites, documentation portals, and hybrid sites.
  • Design navigation schemas (header, footer, breadcrumbs) and URL patterns that reflect site structure.
  • Create visual sitemaps and ASCII/mermaid representations to communicate architecture to design and engineering teams.

Quick Start

Outline a target sitemap for a new site and present an ASCII hierarchy and Mermaid diagram.

Frequently Asked Questions about site-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an intuitive site architecture for a SaaS marketing site?

To create an intuitive site architecture, define a flat-to-moderate page hierarchy that ensures 3-click accessibility for all key pages. This involves mapping parent and child pages, designing clear navigation schemas, and structuring URLs to reflect the content hierarchy accurately.

What is the best way to design URL structure and breadcrumbs for a documentation portal?

The best way to design URL structure and breadcrumbs is to enforce URL readability and breadcrumb semantics. This means creating URL patterns that mirror the site's information hierarchy, ensuring navigation paths are logical and easily understandable by both users and search engines.

Can I generate visual sitemaps and diagrams to communicate navigation design to engineers?

Yes, you can generate visual sitemaps by creating ASCII hierarchy and Mermaid diagram representations. These visual outputs translate navigation design and information hierarchy into clear, developer-friendly formats for engineering and design teams.

Does internal linking follow a specific model for content blogs and hybrid sites?

Internal linking follows a hub-and-spoke model, connecting related pages through a central topic page. This approach ensures content blogs and hybrid sites maintain a structured information hierarchy and flat-to-moderate depth for optimal crawlability and user navigation.

How many clicks should it take to reach any page in a well-structured website hierarchy?

A well-structured website hierarchy enforces a 3-click accessibility rule, meaning any page should be reachable within three clicks from the homepage. This flat-to-moderate depth prevents deep nesting and improves overall site findability and usability.