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
41
GitHub Stars
2.3K
First Seen
4 days ago
site-structure-optimizer — aaron-he-zhu/aaron-marketing-skills