Link Auditor Skill

Hugo site link health analysis through a 4-phase pipeline: Scan, Analyze, Validate, Report. Extracts internal, external, and image links from Hugo markdown content; builds an adjacency matrix of internal link relationships; identifies orphan pages, under-linked pages, link sinks, and hub pages; validates that link targets resolve to real files; and generates audit reports with actionable fix suggestions.

Read and follow the repository CLAUDE.md before starting any audit.

Instructions

Phase 1: SCAN

Goal: Extract all links from every markdown file and classify them by type.

Step 1: Identify content root

Scan all markdown files in content/ because even small sites with 10 posts can have orphan pages, and partial scans miss graph-level issues. Locate the Hugo content directory and enumerate all markdown files:

# TODO: scripts/link_scanner.py not yet implemented
# Manual alternative: extract links from markdown files