# Optimize Your Site Structure and Internal Links

Complex websites hide important pages and weaken navigation. This skill creates a clear hierarchy, URL plan, link map, and prioritized implementation roadmap.

## Install

```bash
npx skillstore add aaron-he-zhu/site-structure-optimizer
```

## Metadata

- Status: approved
- Slug: aaron-he-zhu-site-structure-optimizer
- Version: 17.0.0
- Author version: 17.0.0
- Skillstore revision: r1
- Version status: valid
- Tree hash: 205372dd64ac3c82df3742f3181a92150d9899a464fdffd1923320e113801d6f
- Author: aaron-he-zhu
- GitHub username: aaron-he-zhu
- License: Apache-2.0
- Repository: https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/main/seo-geo/optimize/site-structure-optimizer
- Ref: d71c7417a35d5c2624161bd2fe8de8a41a362128
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: filesystem, external\_commands, network
- Quality score: 78
- Quality tier: bronze
- Public page: https://skillstore.pages.dev/skills/aaron-he-zhu-site-structure-optimizer
- Manifest: https://skillstore.pages.dev/api/skills/aaron-he-zhu-site-structure-optimizer/manifest

## Capabilities

- Selects architecture or linking mode from the request.
- Designs page hierarchies, navigation zones, and URL taxonomies.
- Maps hub-and-spoke topic clusters and cross-section links.
- Identifies orphan pages, link islands, crawl-depth issues, and anchor-text problems.
- Produces Mermaid site maps, structure scores, redirect guidance, and prioritized action plans.

## Use Cases

- Plan a New Website: Create a page hierarchy, navigation model, URL taxonomy, and topic clusters before development begins.
- Restructure a Growing Site: Find buried pages, inconsistent URL parents, weak navigation, and migration risks across an established website.
- Improve Internal Links: Identify orphans, weak authority flow, generic anchors, and specific source-to-target link opportunities.

## Prompt Templates

### Create a Basic Site Plan

```
Use architecture mode for a new [site type] website. Organize these pages: [page list]. Propose hierarchy, navigation, URLs, and topic clusters.
```

### Restructure an Existing Site

```
Review this sitemap or page inventory: [pages]. Preserve these URLs: [URLs]. Design a clearer structure and include redirects for changed URLs.
```

### Audit Internal Linking

```
Use linking mode for [domain or sitemap]. Identify orphans, deep pages, link islands, anchor issues, and prioritized source-target-anchor recommendations.
```

### Plan a Controlled Migration

```
Design a phased migration from [current model] to [target model]. Include URL mapping, redirects, navigation changes, link updates, risks, metrics, and validation gates.
```

## Limitations

- Requires a domain, sitemap, page inventory, or user-provided site details.
- Cannot measure live metrics without connected crawler, SEO, or analytics tools.
- Does not analyze external backlinks, XML sitemap health, or indexation.
- Recommendations need human review before URL changes, redirects, deletion, or noindex actions.

## Best Practices

- Provide a complete page inventory and mark the most important pages.
- Separate measured data, user-provided facts, and estimates.
- Review traffic and rankings before deleting, redirecting, or hiding orphan pages.

## Anti Patterns

- Do not change live URLs without a complete redirect map.
- Do not treat estimated crawl or link metrics as measured results.
- Do not add links only to meet a quota when topics are unrelated.

## Security Audit

- Audited at: 2026-07-12T14:06:08.403\+00:00
- Summary: Two findings are confirmed because the skill instructs agents to run Python crawler and link-analysis helpers. All other findings are Markdown formatting, relative documentation links, diagrams, or repository metadata. No prompt injection or malicious intent was found.

## Stats

- Views: 0
- Downloads: 7
- Favorites: 0
- Popularity score: 0