link-auditor

Extract Hugo site links and generate structured audit reports.

415|44|Updated Mar 18, 2026
One-click install
npx skills add https://github.com/notque/claude-code-toolkit --skill link-auditor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: link-auditor
Source: https://github.com/notque/claude-code-toolkit/tree/main/skills/link-auditor
Command: npx skills add https://github.com/notque/claude-code-toolkit --skill link-auditor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill analyzes and reports on Hugo site link health, identifying broken paths, orphan pages, and weak internal linking to improve crawlability and SEO while keeping content safe from automatic changes.

Core Features & Use Cases

  • Extract internal, external, and image links from Hugo markdown content
  • Build an internal link graph and compute inbound/outbound metrics
  • Detect orphan pages, under-linked pages, link sinks, and hub pages
  • Validate internal targets against Hugo path resolutions and verify image existence in static/
  • Optionally validate external URLs via HTTP HEAD requests
  • Generate structured audit reports with actionable recommendations

Quick Start

Run the link auditor against your Hugo content with python3 scripts/link_scanner.py /path/to/content to generate an audit.

Frequently Asked Questions about link-auditor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit Hugo site links for broken paths and SEO issues?

To audit Hugo site links, run a scanner against your content directory to extract internal, external, and image links, validate target existence, and generate a structured report on structural SEO issues and broken paths.

How do I find orphan pages and under-linked content in Hugo markdown?

Finding orphan pages and under-linked content in Hugo markdown requires building an internal link graph to compute inbound metrics, identifying pages with zero or very few internal links pointing to them.

Can I validate external URLs and image links in Hugo without automatically changing content?

You can validate external URLs via optional HTTP HEAD requests and verify image existence in the static directory, ensuring content remains completely safe from automatic changes during the audit.

What is a link graph and how does it identify link sinks and hub pages?

A link graph maps internal connections between pages to compute inbound and outbound metrics, revealing link sinks with excessive outbound links and hub pages that act as central navigation nodes.

Does Hugo link auditing require additional dependencies or external packages?

Hugo link auditing runs as a standalone Python script against your content directory and requires no additional dependencies or external packages to extract links and generate the audit report.

What are the limitations of using a static link scanner for Hugo SEO?

Static link scanning limitations include relying on Hugo path resolutions from markdown files rather than rendered HTML, meaning dynamically generated links or client-side routing are not captured in the audit.