site-architecture

Plan website information architecture and generate ASCII Mermaid visual sitemaps.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you plan and optimize a website's information architecture to improve usability and crawlability.

Core Features & Use Cases

  • Identify optimal page hierarchies and URL patterns for SaaS, marketing sites, or documentation portals.
  • Design navigation schemes (header, footer, sidebars) and breadcrumbs that reflect the information architecture.
  • Create ASCII or Mermaid visual sitemaps to communicate the planned structure to design and engineering teams.
  • Use cases include planning a new site, restructuring an existing site, or migrating to a cleaner IA without breaking redirects.

Quick Start

Draft a 3-level sitemap for the main product, blog, and docs sections and outline the primary navigation and a sample URL structure.

Frequently Asked Questions about site-architecture

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

FAQPage Schema
What is the best way to design a scalable site architecture for a SaaS marketing site?

The best way to design a scalable site architecture is to map clear page hierarchies and consistent URL patterns. This approach targets SaaS marketing sites by delivering visual sitemaps, recommended navigation schemas, and URL structures with 2-3 levels of depth.

How do I create a visual sitemap using Mermaid to communicate page hierarchies?

You can create a visual sitemap by mapping your website's information architecture into an ASCII Mermaid diagram. This visual sitemap clearly communicates the planned page hierarchies and navigation structures to design and engineering teams.

How do I plan URL structures and internal linking for a documentation portal?

To plan URL structures for a documentation portal, define 2-3 levels of depth and consistent URL patterns. This ensures scalable internal linking and crawlability, while breadcrumbs guidance improves user navigation across the docs portal.

Does this information architecture planning work for hybrid setups with content sites and docs?

Yes, information architecture planning works for hybrid setups containing content sites, marketing pages, and docs portals. It targets these environments by designing clear page hierarchies, navigation schemes, and consistent URL patterns that scale.

Why does my website need breadcrumbs and a specific navigation design?

Your website needs breadcrumbs and structured navigation design to improve usability and crawlability. A well-planned navigation schema reflects the underlying information architecture, ensuring users and crawlers can easily understand page hierarchies.

Can I restructure an existing site's information architecture without breaking redirects?

Yes, you can restructure an existing site's information architecture without breaking redirects. By planning a cleaner IA and mapping optimal page hierarchies alongside consistent URL patterns, you can migrate content safely while maintaining crawlability.