site-architecture

Generate ASCII hierarchies and Mermaid sitemaps with navigation zones for site architecture.

Updated Apr 14, 2026
One-click install
npx skills add https://github.com/gerald-ica/opencode-config-snapshot --skill site-architecture-gerald-ica
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/gerald-ica/opencode-config-snapshot/tree/main/opencode/skills/site-architecture
Command: npx skills add https://github.com/gerald-ica/opencode-config-snapshot --skill site-architecture-gerald-ica

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Plan clear, scalable website structures by defining page hierarchies, navigation, and URL patterns to improve findability and usability.

Core Features & Use Cases

  • Plan page hierarchies, navigation schemas, and URL schemes tailored to different site types (SaaS, content, docs)
  • Generate ASCII trees and Mermaid sitemaps for design handoff and stakeholder review
  • Provide an internal linking blueprint and best-practice guidelines for navigation and IA across common site types

Quick Start

Describe your site goals and page inventory, and the Skill will output a full ASCII hierarchy and Mermaid sitemap.

Frequently Asked Questions about site-architecture

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

FAQPage Schema
How do I create a visual sitemap for website planning?▼

To create a visual sitemap for website planning, define your site goals and page inventory to generate a Mermaid visual sitemap. This output includes navigation zones and an ASCII hierarchy to improve overall findability and SEO.

What is the 3-click rule in site architecture?▼

The 3-click rule in site architecture is a usability guideline stating users should reach any page within three clicks. It is applied by flattening page structures and optimizing navigation schemas to ensure clear findability.

How do I generate a URL structure and navigation spec for a SaaS site?▼

To generate a URL structure and navigation spec for a SaaS site, input your page inventory and goals. The system outputs a complete URL map and navigation specification tailored to different site types like SaaS, content, or documentation.

Can I use an ASCII tree for design handoff and stakeholder review?▼

Yes, you can use an ASCII tree for design handoff and stakeholder review. It is generated alongside a Mermaid diagram to provide a clear, text-based page hierarchy that makes website structure communication straightforward.

What's the best way to plan internal linking within an information architecture?▼

The best way to plan internal linking within an information architecture is to use a dedicated blueprint. It defines optimal URL patterns and page hierarchies, flattening structures where possible to enhance SEO and user navigation.

Do I need a full page inventory before defining site architecture?▼

Yes, providing a page inventory is required before defining site architecture. Describing your site goals and existing pages allows the system to organize navigation, apply the 3-click rule, and generate accurate URL schemes.