site-structure-optimizer

Installation
SKILL.md

Site Structure Optimizer

Works one lever of site structure at two altitudes. Architecture mode designs the whole-site information architecture — page hierarchy, navigation, URL taxonomy, hub/spoke topic clusters, link topology — and renders Mermaid site maps that make orphans and link islands visible. Linking mode optimizes the links inside an existing structure — link graph, authority flow, anchor text, orphan disposition — and delivers a prioritized source/target/anchor plan. Both emit a structure score /100 and a handoff summary.

Scope guard: this skill does not compute the CORE-EEAT score or run vetoes (T04, C01, R10) — that is the content-quality-auditor gate. It does not analyze external backlinks (offsite-signal-analyzer) or diagnose XML sitemaps / indexation (technical-seo-checker). It works the structure lever and hands off.

Mode Selector

Mode Altitude Use when Core outputs
architecture Whole-site layout New build or restructure; the layout itself is the question ASCII hierarchy tree, URL map table, nav spec, hub/spoke plan, Mermaid site map, architecture score /100
linking Links inside an existing layout Pages exist; the question is how they connect Orphan list + disposition, anchor-text distribution, contextual link plan (source/target/anchor), structure score /100

Pick the mode from --mode if given. Otherwise infer: "plan / design structure / URL taxonomy / hub-spoke / sitemap" → architecture; "fix internal linking / orphan pages / anchor text / authority flow" → linking. If the request spans both (e.g., "restructure the site AND fix the links"), run architecture first, then hand off to linking (see Next Best Skill) — do not silently interleave.

Quick Start

Start with one of these prompts, then finish with the standard handoff summary from Skill Contract.

Installs
738
GitHub Stars
2.6K
First Seen
Jul 3, 2026
site-structure-optimizer — aaron-he-zhu/aaron-marketing-skills