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.