site-architecture

Plan website page hierarchies, navigation, URL structures, and internal linking strategies.

Updated Jun 3, 2026
One-click install
npx skills add https://github.com/MohmmedKudmani/mk-ai-os --skill site-architecture-mohmmedkudmani
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: site-architecture
Source: https://github.com/MohmmedKudmani/mk-ai-os/tree/main/.opencode/skills/marketing/seo-content/site-architecture
Command: npx skills add https://github.com/MohmmedKudmani/mk-ai-os --skill site-architecture-mohmmedkudmani

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Planning or restructuring a website's information architecture is difficult: pages get buried, navigation becomes cluttered, URLs grow inconsistent, and internal linking is neglected. This Skill produces a complete site architecture plan covering page hierarchy, navigation design, URL patterns, and internal linking so the site works for both users and search engines. ## Core Features & Use Cases - Page Hierarchy Design: Applies the 3-click rule and flat-vs-deep tradeoffs to produce ASCII tree structures and Mermaid visual sitemaps for any site type (SaaS, blog, e-commerce, docs, hybrid, small business). - URL Structure & Navigation Specs: Generates URL maps with consistent patterns, header/footer/sidebar navigation layouts, and breadcrumb implementations aligned to the hierarchy. - Internal Linking Strategy: Builds hub-and-spoke linking models, orphan page audits, and cross-section link plans. - Use Case: A SaaS company adding 200 integration pages and 50 comparison pages asks how they fit into the site. The Skill recommends hub pages at /integrations and /compare, keeps them out of the main nav, and defines the hub-and-spoke linking model. ## Quick Start Ask the assistant to plan the site architecture for your website, describing your site type, main sections, and whether it is a new build or a restructure.

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 site structure and page hierarchy?▼

Start with a content inventory and business goals, then apply the 3-click rule so important pages sit within three levels of the homepage. Produce an ASCII tree of the full hierarchy, a URL map table, and a navigation spec covering header, footer, and breadcrumbs.

What URL structure should I use for blog posts and feature pages?▼

Use short, readable, lowercase hyphenated paths that mirror the hierarchy, such as /blog/post-slug and /features/feature-name. Avoid dates, IDs, query parameters, and deep nesting, and keep one consistent pattern per section.

How many items should a website header navigation have?▼

Keep the primary header navigation to 4-7 items with the CTA button rightmost. If sections grow beyond that, group pages into dropdowns or mega menus limited to 2-4 columns rather than adding more top-level items.

Does this skill handle XML sitemaps and crawl errors?▼

No. XML sitemaps, crawl errors, and indexation issues are technical SEO tasks handled by the seo-audit skill. This skill covers information architecture design: page hierarchy, navigation, URL patterns, and internal linking.

How do I organize hundreds of programmatic SEO pages in site architecture?▼

Create hub pages such as /integrations or /compare that link to all generated pages, and keep those pages out of the main navigation. Apply the hub-and-spoke internal linking model so each spoke links back to its hub and to related spokes.