internal-linking-optimizer

name	internal-linking-optimizer
description	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". Analyzes and optimizes internal link structure to improve site architecture, distribute page authority, and help search engines understand content relationships. Creates strategic internal linking plans. For a broader on-page audit, see on-page-seo-auditor. For external link analysis, see backlink-analyzer.
license	Apache-2.0
metadata	{"author":"aaron-he-zhu","version":"2.0.0","geo-relevance":"low","tags":["seo","internal linking","site architecture","link structure","page authority","link equity","content silos","navigation optimization"],"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 · Install all: npx skills add aaron-he-zhu/seo-geo-claude-skills

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

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

   ## 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
   

2. Identify Orphan Pages

   ## 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
   

3. Analyze Anchor Text Distribution

Validation Checkpoints

Input Validation

• Site structure or sitemap provided (URL or file)
• Target pages or topic clusters clearly defined
• If optimizing specific page, page URL or content provided

Output Validation

• Every recommendation cites specific data points (not generic advice)
• All link suggestions include source page, target page, and recommended anchor text
• Orphan page lists include URLs and recommended actions
• Source of each data point clearly stated (~~web crawler data, ~~analytics, user-provided, or manual analysis)

Example

User: "Find internal linking opportunities for my blog post about 'email marketing best practices'"

Output:

## Internal Linking Opportunities

**Page**: /blog/email-marketing-best-practices/
**Current Internal Links**: 2

### Recommended Links to Add

| Section | Text to Link | Target Page | Anchor |
|---------|--------------|-------------|--------|
| Para 2 | "building your email list" | /blog/grow-email-list/ | "building your email list" |
| Para 5 | "subject lines" | /blog/email-subject-lines/ | "write compelling subject lines" |
| Section on segmentation | "audience segments" | /blog/email-segmentation-guide/ | "segment your audience" |
| CTA section | "marketing automation" | /services/email-automation/ | "email automation services" |
| Conclusion | "email marketing tools" | /blog/best-email-tools/ | "top email marketing tools" |

### Pages That Should Link TO This Article

| Source Page | Location | Anchor Text |
|-------------|----------|-------------|
| /blog/digital-marketing-guide/ | Email section | "email marketing best practices" |
| /services/marketing-services/ | Related content | "email marketing strategies" |
| /blog/lead-generation-tips/ | Email mention | "email marketing techniques" |

### Priority Actions

1. Add 5 outbound internal links (listed above)
2. Request 3 inbound links from related pages
3. Add to "Marketing" category page

Tips for Success

1. Quality over quantity - Add relevant links, not random ones
2. User-first thinking - Links should help users navigate
3. Vary anchor text - Avoid over-optimization
4. Link to important pages - Distribute authority strategically
5. Regular audits - Internal links need maintenance as content grows

Link Architecture Patterns

Common Architecture Models

Model	Description	Best For	Limitations
Hub-and-Spoke	Central pillar links to/from cluster pages	Topic authority, content hubs	Can isolate topic clusters
Silo Structure	Strict category hierarchies, vertical linking	Large e-commerce, strict taxonomy	Limits cross-topic discovery
Flat Architecture	All pages 2-3 clicks from homepage	Small sites (<100 pages)	Doesn't scale to large sites
Pyramid	Homepage → Categories → Subcategories → Pages	News sites, large blogs	Deep pages get less authority
Mesh/Matrix	Cross-links between related content freely	Knowledge bases, wikis	Can become chaotic without rules

Hub-and-Spoke Implementation

Homepage
  └── Topic Hub A (pillar page)
  │     ├── Cluster Article A1 ←→ A2
  │     ├── Cluster Article A2 ←→ A3
  │     └── Cluster Article A3 ←→ A1
  └── Topic Hub B (pillar page)
        ├── Cluster Article B1 ←→ B2
        └── Cluster Article B2 ←→ B1

Cross-links: A2 → B1 (related subtopics)

Anchor Text Diversity Framework

Anchor Text Types

Type	Example	Target Distribution	Risk Level
Exact match	"keyword research tools"	10-15%	Over-optimization risk if higher
Partial match	"best tools for keyword research"	20-30%	Safe, natural variation
Branded	"Ahrefs keyword explorer"	15-25%	Always safe
Generic	"click here", "learn more", "read this"	5-10%	Low SEO value
Descriptive/natural	"this comprehensive guide covers..."	20-30%	Most natural, recommended
Naked URL	"example.com/page"	5-10%	Natural for citations

Anchor Text Best Practices

• Vary anchor text for the same target page
• Use descriptive text that tells users AND search engines what to expect
• Never use identical anchor text for different target pages
• Monitor for accidental over-optimization of commercial keywords

Link Equity Flow Model

Link Equity Distribution

Page Position	Equity Received	Action to Increase
Homepage	Highest (all external links flow here)	Distribute to key pages via prominent links
Category pages	High (linked from homepage + child pages)	Link to from blog posts, not just nav
Top content	Medium-High (if well-linked internally)	Increase internal links from other strong pages
Deep pages	Low (few internal links)	Add contextual links from related pages
Orphan pages	Zero (no internal links!)	Critical: add at least 3 internal links

Link Equity Optimization Rules

1. Link from strong pages to weak pages — pages with high authority should link to priority pages
2. Reduce click depth — important pages should be within 3 clicks of homepage
3. Fix orphan pages — every page needs at least one internal link
4. Use contextual links — links within body content pass more value than navigation/footer links
5. Limit links per page — diminishing returns above 100 internal links per page

Internal Link Audit Checklist

Check	Tool/Method	Pass Criteria
Orphan pages	Crawl report	Zero orphan pages
Click depth	Crawl report	All priority pages ≤3 clicks from home
Broken internal links	Crawl report	Zero 404 internal links
Redirect chains	Crawl report	No chain >2 redirects
Anchor text diversity	Manual audit	No anchor text >30% exact match
Bidirectional links	Manual audit	Related pages link to each other
Navigation consistency	Manual audit	Key pages in main nav
Contextual links per page	Manual audit	3-5 contextual links per 1000 words

Reference Materials

• Link Architecture Patterns — Architecture models, implementation guides, and link equity optimization strategies

Related Skills

• content-gap-analysis — Find content to link to
• seo-content-writer — Create linkable content
• on-page-seo-auditor — Audit overall on-page SEO
• technical-seo-checker — Check crawlability
• content-quality-auditor — Full 80-item CORE-EEAT audit
• schema-markup-generator — Breadcrumb and navigation schema