site-architecture

Plan site architecture with ASCII hierarchies, Mermaid sitemaps, and navigation specs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Organize and optimize a website's page hierarchy, navigation, and URL structure to make it intuitive for users and friendly for search engines.

Core Features & Use Cases

  • Create ASCII trees of page hierarchies to plan and communicate structure.
  • Generate Mermaid visual sitemaps to illustrate navigation zones and relationships.
  • Produce a comprehensive navigation spec, URL map, and internal linking plan for both new builds and restructures.
  • Support for scalable programmatic content planning and alignment with SEO best practices.

Quick Start

Draft a concise, actionable site-structure plan based on the user brief.

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's URL structure and internal linking for SEO?

Plan site architecture by applying hub-and-spoke or flat structures to organize pages, generating a URL map and internal linking plan that aligns with SEO best practices to optimize findability.

What is the best way to visualize a page hierarchy for a new website?

Visualize a page hierarchy by generating an ASCII tree of your site structure and a Mermaid visual sitemap. These formats illustrate navigation zones and page relationships, making it easy to communicate your architecture plan to stakeholders.

When do I need to use a hub-and-spoke site architecture instead of a flat structure?

Use a hub-and-spoke site architecture when you need to organize content into topical clusters around central pages, and apply a flat structure when you want minimal click depth. The right choice depends on your content volume and user flow goals.

Can I plan programmatic content at scale using a site architecture mapping process?

Yes, you can plan programmatic content at scale by designing a site architecture that accommodates scalable URL structures and navigation patterns. This ensures your page hierarchy and internal linking plan remain intuitive as programmatic pages grow.

How do I create a navigation spec for a website restructure?

Create a navigation spec for a website restructure by mapping your new page hierarchy into an ASCII tree, defining navigation zones with a Mermaid sitemap, and documenting the URL map and internal linking plan to guide the implementation.

Does internal linking affect site architecture and user flow optimization?

Internal linking is a core component of site architecture that directly affects user flow optimization. A planned internal linking strategy connects pages logically within the hierarchy, improving findability and distributing SEO authority across the site.