Agent skill · Content & Marketing

site-structure-optimizer

Use when the user asks to "plan my site structure", "design the page hierarchy / navigation / URL taxonomy", "fix internal linking", or "find orphan pages"; runs two modes — architecture (hierarchy, nav, URL patterns, hub/spoke clusters, Mermaid site maps) and linking (link graph, authority flow, anchor text, orphan disposition, source/target/anchor plan) — and outputs a structure score /100 plus a handoff summary. Not for external backlinks — use offsite-signal-analyzer; not for XML sitemap or indexation issues — use technical-seo-checker. 网站架构/信息架构/站点地图/内链优化

aaron-he-zhugithub.com/aaron-he-zhuGitHub ↗
claude-codeApache-2.0
Install
npx skills add aaron-he-zhu/aaron-marketing-skills --skill site-structure-optimizer --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 6
SKILL.md size: 15 KB
Bundled scripts: none
Version: 19.1.0
Requires: Claude Code and compatible agent-skill hosts
Path: seo-geo/tune/site-structure-optimizer/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 2,508
Language: Python
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the 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` |

What's inside
Steps it walks through
  1. Mode Selector
  2. Quick Start
  3. Skill Contract
  4. Handoff Summary
  5. Data Sources
  6. Instructions
  7. Mode: architecture
  8. Mode: linking
  9. Decision Gates
  10. Example
  11. Save Results
  12. Reference Materials
  13. Next Best Skill
Ships with 5 files
  • references/link-architecture-patterns.md
  • references/linking-example.md
  • references/linking-templates.md
  • references/mermaid-templates.md
  • references/site-type-patterns.md
More from aaron-marketing-skills
All skills →
About this skill
What does the site-structure-optimizer skill do?

Use when the user asks to "plan my site structure", "design the page hierarchy / navigation / URL taxonomy", "fix internal linking", or "find orphan pages"; runs two modes — architecture (hierarchy, nav, URL patterns, hub/spoke clusters, Mermaid site maps) and linking (link graph, authority flow, anchor text, orphan disposition, source/target/anchor plan) — and outputs a structure score /100 plus a handoff summary. Not for external backlinks — use offsite-signal-analyzer; not for XML sitemap or indexation issues — use technical-seo-checker. 网站架构/信息架构/站点地图/内链优化

How do I install it?

Run `npx skills add aaron-he-zhu/aaron-marketing-skills --skill site-structure-optimizer --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From aaron-he-zhu/aaron-marketing-skills, a repository with 2,508 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going