Skip to content

aaron-he-zhu/aaron-marketing-skills / seo-geo/tune/site-structure-optimizer

site-structure-optimizer

Verified

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. 网站架构/信息架构/站点地图/内链优化

references/linking-templates.md

View on GitHub
# Linking Templates (linking-mode steps 3–7)

Copy-paste output templates for linking mode in [SKILL.md](../SKILL.md). Each template maps to one step. Label every metric **Measured**, **User-provided**, or **Estimated**. Threshold defaults live in [Link Architecture Patterns](link-architecture-patterns.md).

## Anchor & Link Rules (apply throughout)

- **Descriptive over generic**: anchor should describe the target ("email segmentation guide"), not "click here" / "read more".
- **Contextual over navigational**: in-body links inside relevant prose carry more weight than menu/footer links. Count them separately.
- **Link-depth budget**: important pages ≤3 clicks from home; each in-body link ≈ 1 unit of PageRank divided among all links on the page — do not exceed the model's avg-links/page target.
- **One primary target per anchor**: avoid pointing the same exact-match anchor at multiple pages.
- **No redirect chains**: link to the final URL.

> Exact-match anchor guidance tightened: the old 10–20% allowance is retired in favor of **<5% per target** (the stricter current scheme) — repeated exact-match anchors above this read as over-optimization.

## Step 3 — Anchor-Text Distribution

```text
Anchor-Text Distribution — [domain]
Data source: [Measured/Estimated]

| Anchor type          | Count | Share | Target        | Flag |
|----------------------|-------|-------|---------------|------|
| Descriptive/topical  |       |    %  | 60–80%        |      |
| Branded/navigational |       |    %  | 10–20%        |      |
| Generic              |       |    %  | <10%          |      |
| Exact-match (repeat) |       |    %  | <5% / target  |      |

Over-optimized anchors (exact-match > threshold): [list target → anchor → count]
Generic anchors to rewrite: [source → current anchor → suggested descriptive anchor]

Anchor Score /10: [n]
  Start 10; −2 if generic >10%; −2 if any exact-match >5% to one target;
  −2 if descriptive <60%; −1 per over-optimized cluster (cap −4). Floor 0.
```

## Step 4 — Topic Cluster Link Strategy

```text
Topic Clusters — [domain]

| Pillar (hub) | Spokes (in-cluster) | Missing hub→spoke | Missing spoke→hub | Cross-links to add |
|--------------|---------------------|-------------------|-------------------|--------------------|
|              |                     |                   |                   |                    |

Recommended structure: [hub-spoke / silo / mesh] — see Link Architecture Patterns
Specific links to add: [source → target → anchor → reason]
```

## Step 5 — Contextual Link Opportunities

```text
Contextual Link Plan — [page or domain]

| # | Source page (+paragraph) | Target URL | Suggested anchor | Priority | Target resolves? |
|---|--------------------------|------------|------------------|----------|------------------|
| 1 |                          |            |                  | High     | Yes/No (404→flag)|

Broken targets flagged for content-quality-auditor (R10): [list]
```

## Step 6 — Navigation & Footer Links

```text
Navigation Review — [domain]

| Zone       | Current items | Add | Demote | Remove | Reason |
|------------|---------------|-----|--------|--------|--------|
| Header     |               |     |        |        |        |
| Footer     |               |     |        |        |        |
| Sidebar    |               |     |        |        |        |
| Breadcrumb |               |     |        |        |        |

Header rule: 4–7 items, CTA rightmost, logo → home. Breadcrumbs mirror the URL path.
```

## Step 7 — Implementation Plan

```text
Internal Linking Plan — [domain]  |  Structure Score: [n]/100

Executive summary: [1–2 lines: biggest structural gap + expected effect]

Current-state metrics (label each Measured/Estimated):
- Pages analyzed / total internal links / avg links per page
- Orphans / under-linked important pages / max click depth

Phased priority actions:
  P1 (blocking): [orphans of high-value pages, migrations without 301]
  P2 (this sprint): [add contextual links, rewrite generic anchors]
  P3 (backlog): [nav/footer tuning, low-value orphan disposition]

Implementation guide: [source → target → anchor, grouped by page]
Tracking plan: re-crawl cadence; metrics to watch (orphan count, avg depth, anchor mix)
Handoff: veto-level risks (migration w/o redirect, broken targets) → content-quality-auditor
```
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall