By name: checking-urls description: Validates all URLs (internal relative links and external URLs) in markdown files. Use when adding new content, after making changes, or when asked to check/audit links.
URL Checking Skill
Validates all URLs in the repository to ensure they are active and valid.
When to Use
- Automatically when new weekly entries or posts are added
- On demand when asked to check links
- Periodically to audit existing content
Capabilities
- Internal links: Validates relative paths to other markdown files
- External links: Checks HTTP/HTTPS URLs are accessible (2xx/3xx status)
- Anchor links: Validates
#sectionreferences exist in target files - Logging: Records all checks to
logs/url-checks/YYYY-MM-DD.log
Workflow
Run the Check Script
./scripts/check-urls.sh
This will:
- Scan all
.mdfiles for URLs - Validate internal relative links
- Check external URLs with HEAD requests
- Write results to
logs/url-checks/YYYY-MM-DD.log
Log Format
[YYYY-MM-DD HH:MM:SS] CHECKING: source_file.md
[YYYY-MM-DD HH:MM:SS] ✓ VALID: ./weeks/2025/week-01/README.md
[YYYY-MM-DD HH:MM:SS] ✗ INVALID: <url> (404)
[YYYY-MM-DD HH:MM:SS] ✗ MISSING: ./weeks/2025/nonexistent.md
When Invalid URLs Found
- The script outputs a summary of broken links
- Alert the user about each invalid URL
- Continue alerting on subsequent runs until fixed
- Check
logs/url-checks/for history
Invalid URL Tracking
The script maintains logs/url-checks/UNRESOLVED.md with currently broken links.
On each run, this file is updated. Use it to track what needs fixing.