site-architecture

Plan and document website architectures with ASCII trees, Mermaid diagrams, and URL maps.

5|2|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/Imd11/marketing-skills --skill site-architecture-imd11
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/Imd11/marketing-skills/tree/main/site-architecture
Command: npx skills add https://github.com/Imd11/marketing-skills --skill site-architecture-imd11

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Plan and document scalable website architectures including page hierarchies, navigation, and URL schemes to improve usability, SEO, and maintainability.

Core Features & Use Cases

  • Generate ASCII-tree representations of site hierarchies for quick stakeholder review.
  • Produce Mermaid visual sitemaps to illustrate navigation zones and relationships.
  • Create URL maps, navigation specs, and internal linking plans that scale from small sites to complex hybrid architectures.
  • Assist in restructuring efforts with before/after ASCII trees and proposed taxonomy for pages and sections.

Quick Start

Draft a starter site plan by outlining the homepage, top-level sections, and one subpage under each section to establish the initial hierarchy.

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 scalable website architecture for a SaaS marketing site?

Plan scalable website architecture by defining page hierarchies, navigation zones, and URL schemes. This generates an ASCII tree, a Mermaid visual sitemap, a formal URL map, and a navigation specification to ensure usability and SEO maintainability.

What is the best way to document site hierarchy and URL structure?

Document site hierarchy and URL structure using ASCII trees for quick stakeholder review and Mermaid diagrams for visual sitemaps. This approach outputs a formal URL map and internal linking plan that scales from small sites to complex hybrid configurations.

Can I generate a visual sitemap and navigation spec for a content-driven site?

You can generate a visual sitemap and navigation spec for content-driven sites by mapping top-level sections and subpages. It produces Mermaid diagrams illustrating navigation relationships and a structured internal linking plan for clear hierarchy.

How do I visualize a website restructuring with before and after sitemaps?

Visualize website restructuring by generating before and after ASCII trees that illustrate the proposed taxonomy for pages and sections. This documents the updated site architecture and navigation zones to improve stakeholder review.

Does this site architecture planning approach work for hybrid site configurations?

This site architecture planning approach supports hybrid configurations requiring clear hierarchy and navigation. It creates URL maps, navigation specs, and internal linking plans that scale effectively for SaaS marketing and content-driven sites.