southgateai avatar

check-links

Check all internal links on the local Hugo site for broken links. Use before pushing to verify site

作者 southgateai|オープンソース

Link Checker

Validates all internal links on the local Hugo development server.

Usage

Run the link checker script:

python .claude/skills/check-links/scripts/check_links.py

What it checks

  • Crawls all pages starting from http://localhost:1313/
  • Follows internal links only (same host)
  • Reports broken links (404s, connection errors)
  • Shows which page contains each broken link

Prerequisites

None. The script reuses an existing Hugo dev server if one is listening on a common port; otherwise it launches its own on an ephemeral port and kills it when the check completes. Do not start a server yourself before running this.

Output

  • Lists any broken links found with their source pages
  • Exits with code 0 if all links valid, 1 if broken links found
check-links - AI Agent Skill for Claude Code & Cursor | Agent Skills