skills.rest
unfinishablemap
unfinishablemapCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/unfinishablemap/unfinishablemap --skill check-links
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
hyperlane-xyzhyperlane-xyz
72

start-http-registry

Launch a local HTTP registry server for infrastructure script testing.

Official
Intermediate
notquenotque
415

link-auditor

Extract Hugo site links and generate structured audit reports.

Community
Advanced
morodomimorodomi
8

hugo-quality

Run Hugo builds, htmltest link checks, and template metrics.

Community
Intermediate
quanghuynguyen1902quanghuynguyen1902

broken-link-checker

Crawl website pages and report broken links with HTTP status categories.

Community
Advanced