--- name: internal-linking-optimizer version: "4.0.0" description: 'Analyze and optimize internal link structure to improve site architecture, distribute page authority, and fix orphan pages. Use when the user asks to "fix internal links", "improve site architecture", "link structure", "distribute page authority", "internal linking strategy", "orphan pages", "site architecture is messy", or "pages have no links pointing to them". For a broader on-page audit, see on-page-seo-auditor. For external link analysis, see backlink-analyzer.' license: Apache-2.0 compatibility: "Claude Code ≥1.0, skills.sh marketplace, ClawHub marketplace, Vercel Labs skills ecosystem. No system packages required. Optional: MCP network access for SEO tool integrations." homepage: "https://github.com/aaron-he-zhu/seo-geo-claude-skills" metadata: author: aaron-he-zhu version: "4.0.0" geo-relevance: "low" tags: - seo - internal linking - site architecture - link structure - page authority - link equity - content silos - navigation optimization - internal-links - site-architecture - link-equity - orphan-pages - topical-authority - hub-and-spoke - pillar-cluster - anchor-text - crawl-depth triggers: - "fix internal links" - "improve site architecture" - "link structure" - "distribute page authority" - "internal linking strategy" - "site navigation" - "link equity" - "orphan pages" - "site architecture is messy" - "pages have no links pointing to them" ---

Internal Linking Optimizer

> SEO & GEO Skills Library · 20 skills for SEO + GEO · ClawHub · skills.sh

Browse all 20 skills

Research · keyword-research · competitor-analysis · serp-analysis · content-gap-analysis

Build · seo-content-writer · geo-content-optimizer · meta-tags-optimizer · schema-markup-generator

Optimize · on-page-seo-auditor · technical-seo-checker · internal-linking-optimizer · content-refresher

Monitor · rank-tracker · backlink-analyzer · performance-reporter · alert-manager

Cross-cutting · content-quality-auditor · domain-authority-auditor · entity-optimizer · memory-management

This skill analyzes your site's internal link structure and provides recommendations to improve SEO through strategic internal linking. It helps distribute authority, establish topical relevance, and improve crawlability.

When to Use This Skill

• Improving site architecture for SEO
• Distributing authority to important pages
• Fixing orphan pages with no internal links
• Creating topic cluster internal link strategies
• Optimizing anchor text for SEO
• Recovering pages that have lost rankings
• Planning internal links for new content

What This Skill Does

1. Link Structure Analysis: Maps current internal linking patterns
2. Authority Flow Mapping: Shows how PageRank flows through site
3. Orphan Page Detection: Finds pages with no internal links
4. Anchor Text Optimization: Improves anchor text diversity
5. Topic Cluster Linking: Creates pillar-cluster link strategies
6. Link Opportunity Finding: Identifies where to add links
7. Navigation Optimization: Improves site-wide link elements

How to Use

Analyze Current Structure

Analyze internal linking structure for [domain/sitemap]

Find internal linking opportunities for [URL]

Create Linking Strategy

Create internal linking plan for topic cluster about [topic]

Suggest internal links for this new article: [content/URL]

Fix Issues

Find orphan pages on [domain]

Optimize anchor text across the site

Data Sources

> Note: All integrations are optional. This skill works without any API keys — users provide data manually when no tools are connected.

> See CONNECTORS.md for tool category placeholders.

With ~~web crawler + ~~analytics connected: Claude can automatically perform a full site crawl via ~~web crawler to map the complete link graph, fetch page performance metrics from ~~analytics to identify high-value pages, and analyze link flow throughout the site. This enables data-driven internal linking strategies.

With manual data only: Ask the user to provide:

1. Sitemap URL or list of important pages
2. Key page URLs that need more internal links
3. Content categories or topic clusters
4. Any existing link structure documentation

Proceed with the analysis using provided data. Note in the output which findings are from automated crawl vs. manual review.

Instructions

When a user requests internal linking optimization:

1. Analyze Current Internal Link Structure

```markdown ## Internal Link Structure Analysis

### Overview

Domain: [domain] Total Pages Analyzed: [X] Total Internal Links: [X] Average Links per Page: [X]

### Link Distribution

| Links per Page | Page Count | Percentage | |----------------|------------|------------| | 0 (Orphan) | [X] | [X]% | | 1-5 | [X] | [X]% | | 6-10 | [X] | [X]% | | 11-20 | [X] | [X]% | | 20+ | [X] | [X]% |

### Top Linked Pages

| Page | Internal Links | Authority | Notes | |------|----------------|-----------|-------| | [URL 1] | [X] | High | [notes] | | [URL 2] | [X] | High | [notes] | | [URL 3] | [X] | Medium | [notes] |

### Under-Linked Important Pages

| Page | Current Links | Traffic | Recommended Links | |------|---------------|---------|-------------------| | [URL 1] | [X] | [X]/mo | [X]+ | | [URL 2] | [X] | [X]/mo | [X]+ |

Structure Score: [X]/10 ```

1. Identify Orphan Pages

```markdown ## Orphan Page Analysis

### Definition Orphan pages have no internal links pointing to them, making them hard for users and search engines to discover.

### Orphan Pages Found: [X]

| Page | Traffic | Priority | Recommended Action | |------|---------|----------|-------------------| | [URL 1] | [X]/mo | High | Link from [pages] | | [URL 2] | [X]/mo | Medium | Add to navigation | | [URL 3] | 0 | Low | Consider deleting/redirecting |

### Fix Strategy

High Priority Orphans (have traffic/rankings): 1. [URL] - Add links from: [relevant pages] 2. [URL] - Add links from: [relevant pages]

Medium Priority Orphans (potentially valuable): 1. [URL] - Add to category/tag page 2. [URL] - Link from related content

Low Priority Orphans (consider removing): 1. [URL] - Redirect to [better page] 2. [URL] - Delete or noindex ```

1. Analyze Anchor Text Distribution

> CORE-EEAT alignment: Internal linking quality maps to R08 (Internal Link Graph) in the CORE-EEAT benchmark -- use descriptive anchors, ensure links support topical authority. See content-quality-auditor for full audit.

...