check-links
Check all internal links on the local Hugo site for broken links. Use before pushing to verify site integrity.
When & Why to Use This Skill
This Claude skill automates the detection of broken internal links within a local Hugo development environment. By crawling the site to identify 404 errors and connection issues, it ensures website integrity and a polished user experience, preventing broken navigation from reaching production.
Use Cases
- Pre-deployment Verification: Use the tool to scan the entire local site before pushing changes to a live environment to ensure all internal links are valid.
- Content Migration & Refactoring: Validate link persistence after restructuring directories, renaming files, or updating the site's permalink configuration.
- Automated Quality Assurance: Integrate the link checker into the local development workflow to catch and fix navigation errors immediately as new content is created.
| name | check-links |
|---|---|
| description | Check all internal links on the local Hugo site for broken links. Use before pushing to verify site integrity. |
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
The Hugo development server must be running:
cd hugo && hugo server
Output
- Lists any broken links found with their source pages
- Exits with code 0 if all links valid, 1 if broken links found