Link Analyzer Skill Skill

Link Analyzer Skill

Purpose

This skill provides comprehensive link analysis for static websites, including:

Internal/external link extraction
Broken link detection (HTTP validation)
Link graph metrics (orphans, sinks, under/over-linked)
False positive filtering (bot blockers, rate limits)
SEO-focused recommendations

When to Use This Skill

User asks to "analyze links" or "check broken links"
User wants to find "orphan pages" or "dead ends"
User mentions "internal linking" or "link structure"
User needs to "find under-linked content"
User wants to identify "link sinks" or "pages with no outbound links"
User asks about "link juice" distribution

Link Analysis Types

1. Outbound Links Analysis

Extracts and categorizes all external links:

Social media links
E-commerce (Amazon, Gumroad)
Email/Phone links
App Store links
General external websites

2. Internal Links Check

Validates all internal links point to existing pages:

Handles path variations (with/without trailing slash)
Checks for index.html alternatives
Reports broken internal links

3. External Links Validation

HTTP checks on external links with smart filtering:

Parallel requests for speed
Retries for transient failures
Filters false positives (bot blockers, rate limits)
Categorizes by error type (404, timeout, SSL, etc.)

4. Link Graph Metrics (NEW)

Builds a complete link graph and calculates:

Orphan Pages: Pages with zero inbound internal links
Under-linked Pages: Pages below inbound link threshold
Over-linked Pages: Pages above outbound link threshold
Link Sinks: Pages that receive links but don't pass them (dead ends)
Link Flow Ratio: Inbound vs outbound balance

Configuration

Create a config.json:

{
  "dist_path": "./dist",
  "site_domain": "example.com",
  "internal_domains": ["example.com", "www.example.com", "wp.example.com"],
  "excluded_paths": ["/tag/", "/category/", "/page/"],
  "http": {
    "timeout": 5,
    "max_workers": 20,
    "retry_count": 1,
    "user_agent": "LinkChecker/1.0"
  },
  "thresholds": {
    "underlinked_min_inbound": 3,
    "overlinked_max_outbound": 50,
    "link_sink_max_outbound": 2
  },
  "false_positive_domains": [
    "linkedin.com",
    "stackoverflow.com",
    "twitter.com",
    "facebook.com"
  ],
  "output": {
    "report_dir": "./reports",
    "data_dir": "./data"
  }
}

Workflow

Full Analysis

python scripts/analyze.py --dist ./dist --full

Individual Analyses

# Outbound links only
python scripts/outbound_links.py --dist ./dist

# Internal links check
python scripts/internal_links.py --dist ./dist

# HTTP validation (requires outbound data)
python scripts/http_checker.py --input outbound_links_data.json

# Link graph metrics
python scripts/link_graph.py --dist ./dist

Output Reports

Link Graph Report

LINK GRAPH ANALYSIS
==================

ORPHAN PAGES (0 inbound links): 15 pages
- /old-page-nobody-links-to/
- /draft-accidentally-published/
...

UNDER-LINKED PAGES (<3 inbound): 47 pages
- /great-article-needs-promotion/ (1 inbound)
- /hidden-gem-content/ (2 inbound)
...

OVER-LINKED PAGES (>50 outbound): 3 pages
- /resources/ (127 outbound)
...

LINK SINKS (receive but don't pass): 23 pages
- /about/ (15 inbound, 0 outbound)
...

Broken Links Report

ACTIONABLE BROKEN LINKS
======================

404 - Page Not Found: 25 links
- https://old-blog.com/post (5 occurrences)
...

Dead Domains: 8 links
- https://defunct-site.com (3 occurrences)
...

Timeouts: 4 links
- https://slow-affiliate.com (2 occurrences)

Metrics Definitions

| Metric | Definition | SEO Impact | |--------|------------|------------| | Orphan Page | Page with 0 inbound internal links | Critical - page may not be indexed | | Under-linked | Page with fewer than threshold inbound links | High - page lacks authority signals | | Over-linked | Page with more than threshold outbound links | Medium - dilutes link equity | | Link Sink | Page with high inbound but low/no outbound | Medium - doesn't distribute link equity | | Link Flow Ratio | Inbound links / Outbound links | Ideal around 1.0 for most pages |

Example Usage

User: "Analyze my site's internal linking and find pages that need more links"

Claude will:

Build complete link graph from static files
Calculate inbound/outbound counts for every page
Identify orphan pages (critical SEO issue)
Find under-linked pages (opportunity for improvement)
Detect link sinks (pages that don't pass equity)
Generate actionable report with recommendations

Agent Skills: Link Analyzer Skill

Skill Files