Agent skill · marketing growth · borghei

site-architecture

Information architecture, URL hierarchy, internal linking strategy, navigation design, and silo structure for websites. Covers architectural audits, new site planning, crawl equity optimization, and topic cluster mapping.

Why this skill is useful

Provides a structured framework for optimizing website architecture that includes specific strategies for URL hierarchy and internal linking not commonly known.

What it needs

About 12k tokens when loaded. Last updated 2026-07-21. 462 stars on the source repository.

What this skill does

Site Architecture & Internal Linking Production-grade website architecture framework covering URL hierarchy design, internal linking strategy, navigation optimization, silo structure, and crawl equity management. Handles architecture audits, new site planning, and restructuring existing sites. --- Table of Contents Operating Modes URL Structure Design Navigation Architecture Silo Structure and Topic Clusters Internal Linking Strategy Crawl Equity Management Architecture Audit Framework Restructuring Playbook Architecture Patterns by Site Type Common Mistakes Output Artifacts Related Skills --- Clarify First Before generating the architecture, confirm these inputs. If any is unknown or vague, ASK — do not assume: [ ] Operating mode — audit current, plan new, internal-linking optimization, or URL restructuring — determines the artifact produced [ ] Site type — SaaS, e-commerce, blog/content, local, docs, or marketplace — selects the URL pattern and architecture template [ ] Core topics / silos — the 3-7 topic clusters the site covers — drives the hub-and-spoke and internal-linking plan [ ] Current URLs / crawl data — sitemap or URL export — required for audits and redirect mapping Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact. Operating Modes Mode 1: Audit Current Architecture Existing site needs structural assessment. Analyze depth distribution, orphan pages, link equity flow, and navigation effectiveness. Mode 2: Plan New Architecture Building from scratch or full redesign. Map business goals to site sections, design URL hierarchy, plan navigation, and define content silos. Mode 3: Internal Linking Optimization Structure is fine but link equity flow needs improvement. Identify hub pages, map spoke content, fix orphans, and optimize anchor text. Mode 4: URL Restructuring Changing URLs on an existing site. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills borghei/site-architecture

View the source on GitHub

Browse the @skills marketplace