check-links

Crawl local Hugo sites and report broken internal links.

3|Updated Dec 30, 2025

Search Tags:#Hugo #link-validation #internal-links #crawl #web-qa #check-links

Ready to run

npx skills add https://github.com/unfinishablemap/unfinishablemap --skill check-links

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: check-links
Source: https://github.com/unfinishablemap/unfinishablemap/tree/main/.claude/skills/check-links
Command: npx skills add https://github.com/unfinishablemap/unfinishablemap --skill check-links

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures your local Hugo site has no broken internal links, preventing 404s and broken navigation before deployment.

Core Features & Use Cases

Crawls the local Hugo site starting from http://localhost:1313/ and collects all internal links.
Validates each internal link and reports broken ones with their source page, enabling quick repairs.
Exits with code 0 when all links are valid and 1 when broken links are found.

Quick Start

Start the Hugo server with the standard development command, then run the script:

Start Hugo: cd hugo && hugo server
Run checker: python .claude/skills/check-links/scripts/check_links.py
Review output: the tool prints broken links grouped by source page; non-zero exit code indicates issues.

Frequently Asked Questions about check-links

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

FAQPage Schema

How do I check for broken internal links on my Hugo site?▼

Yes, broken link validation works by crawling your local Hugo server starting from http://localhost:1313/ and verifying all collected internal links. The tool reports broken links grouped by their source page for quick repairs.

How do I find broken links before deploying my Hugo website?▼

You can find broken links before deployment by running a Python script that crawls your local Hugo site and validates all internal HTTP links. The script exits with code 1 if broken links are found, preventing bad deployments.

Do I need to install external dependencies to validate internal Hugo links?▼

No external dependencies are required to validate internal Hugo links. The solution requires only Python's standard library to crawl the local server and verify HTTP links, ensuring a zero-setup link validation process.

What is the best way to fix 404 errors during Hugo development?▼

The best way to fix 404 errors during Hugo development is to run a local link validation script that identifies broken internal links and prints them grouped by source page. This enables quick repairs before site deployment.

Can I automate link validation for a local Hugo development server?▼

Yes, you can automate link validation by running a Python script against your local Hugo development server. The script exits with code 0 when all links are valid and code 1 when broken links are found, making it suitable for CI pipelines.

Why does my Hugo link checker script exit with code 1?▼

A Hugo link checker script exits with code 1 when broken internal links are found during the local crawl. An exit code of 0 means all internal links on your local server resolved successfully with no 404s.