Internal Linking Optimizer

This skill should be used when the user asks to "fix internal links", "improve site architecture", "link structure", "distribute page authority", "internal l...

Security Scan

The skill's requirements and instructions are internally consistent with an internal-linking/SEO tool: it is instruction-only, asks for an Ahrefs API key (reasonable for automated SEO metrics), and otherwise has no install or unusual privileges.

Purpose & Capability

The skill is an instruction-only internal-linking optimizer and declares AHREFS_API_KEY as its primary credential — that is a plausible and expected credential for fetching site/link metrics from an SEO provider. Minor inconsistency: the metadata lists requires.env: [] but also sets primaryEnv: AHREFS_API_KEY (primary credential is not also listed under requires.env), which is a bookkeeping discrepancy but not a functional red flag.

Instruction Scope

SKILL.md confines actions to site crawling (automated or manual inputs), analysis, and reporting templates. It asks for sitemap/URLs or optional crawler/analytics connectors; it does not instruct reading unrelated local files or environment variables, nor does it direct data to unexpected endpoints beyond 'SEO tool integrations' (e.g., Ahrefs). The instructions are template/report oriented and stay within the stated SEO purpose.

Install Mechanism

No install spec and no code files that execute — instruction-only content only writes prompts/templates. This is the lowest-risk install pattern; nothing is downloaded or written to disk by an installer.

Credentials

The only declared credential is AHREFS_API_KEY (appropriate for SEO data). However, the skill's metadata omits AHREFS_API_KEY from requires.env while still listing it as primaryEnv, which is inconsistent. Confirming that only a single service key is requested and that no unrelated credentials are required is recommended.

Persistence & Privilege

always:false (no forced inclusion) and default autonomous invocation allowed (normal). The skill does not request system-level persistence or to modify other skills/configs. Autonomous network crawling (if enabled) is the main runtime capability to be aware of.

Assessment

This skill appears to do what it claims: analyze internal links and produce implementation plans. It is instruction-only and only nominally requests an Ahrefs API key, which is reasonable for SEO data. Before installing: (1) confirm the maintainer/owner is trusted; (2) if you will provide an AHREFS_API_KEY, create/use a key with minimal necessary scope (read-only) and be prepared to revoke it when finished; (3) ask the author which external endpoints the skill will call (Ahrefs and/or specific crawlers) so you can review network access; (4) if you want to prevent automated crawling or external calls, do not enable autonomous invocation or do the analysis with manual sitemap/URL input only. The metadata inconsistency (primaryEnv present but not listed in requires.env) is a minor bookkeeping issue to clarify with the publisher but not itself malicious.

SEO & GEO Skills Library · 20 skills for SEO + GEO · Install all: npx skills add aaron-he-zhu/seo-geo-claude-skills

<details> <summary>Browse all 20 skills</summary>

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

</details>

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

   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.

   ## Anchor Text Analysis
   
   ### Current Anchor Text Patterns
   
   **Most Used Anchors**:
   
   | Anchor Text | Count | Target Pages | Assessment |
   |-------------|-------|--------------|------------|
   | "click here" | [X] | [X] pages | ❌ Not descriptive |
   | "read more" | [X] | [X] pages | ❌ Not descriptive |
   | "[exact keyword]" | [X] | [page] | ⚠️ May be over-optimized |
   | "[descriptive phrase]" | [X] | [page] | ✅ Good |
   
   ### Anchor Text Distribution by Page
   
   **Page: [Important URL]**
   
   | Anchor Text | Source Page | Status |
   |-------------|-------------|--------|
   | "[anchor 1]" | [source URL] | ✅/⚠️/❌ |
   | "[anchor 2]" | [source URL] | ✅/⚠️/❌ |
   
   **Issues Found**:
   - Over-optimized anchors: [X] instances
   - Generic anchors: [X] instances
   - Same anchor to multiple pages: [X] instances
   
   ### Anchor Text Recommendations
   
   **For Page: [URL]**
   
   Current: "[current anchor]" used [X] times
   
   Recommended variety:
   - "[variation 1]" - Use from [page type]
   - "[variation 2]" - Use from [page type]
   - "[variation 3]" - Use from [page type]
   
   **Anchor Score**: [X]/10
   

4. Create Topic Cluster Link Strategy — Map current pillar/cluster links, recommend link structure, list specific links to add

   Reference: See references/linking-templates.md for the topic cluster link strategy template (Step 4).

5. Find Contextual Link Opportunities — Analyze each page for topic-relevant link opportunities, prioritize high-impact additions

   Reference: See references/linking-templates.md for the contextual link opportunities template (Step 5).

6. Optimize Navigation and Footer Links — Analyze main/footer/sidebar/breadcrumb navigation, recommend pages to add or remove

   Reference: See references/linking-templates.md for the navigation optimization template (Step 6).

7. Generate Link Implementation Plan — Executive summary, current state metrics, phased priority actions (weeks 1-4+), implementation guide, tracking plan

   Reference: See references/linking-templates.md for the full implementation plan template (Step 7).

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

Reference: See references/linking-example.md for a full worked example (email marketing best practices internal linking opportunities).

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

Reference Materials

• Link Architecture Patterns — Architecture models (hub-and-spoke, silo, flat, pyramid, mesh), anchor text diversity framework, link equity flow model, and internal link audit checklist
• Linking Templates — Detailed output templates for steps 6-7 (navigation optimization, implementation plan)
• Linking Example — Full worked example for internal linking opportunities

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