link-checker

name	link-checker
description	Check all links (mermaid images, GitHub URLs, blog posts) in blog and GitHub repositories for 404/503 errors. Run before publishing or as part of routine maintenance.

Link Checker Skill

Verify all links in blog posts and GitHub tutorials are working before publishing or during maintenance.

Usage

# Check all blog posts (full)
bash skills/link-checker/scripts/check-blog.sh

# Check all GitHub tutorials
bash skills/link-checker/scripts/check-github.sh

# Check everything
bash skills/link-checker/scripts/check-all.sh

# Check specific file
bash skills/link-checker/scripts/check-file.sh /path/to/file.md

# Check for Sumopod referral links
bash skills/link-checker/scripts/check-referral.sh

What It Checks

Check	Scope	Detects
Mermaid images	Blog posts	404, 503, timeout
GitHub tutorial links	Blog posts	File not found
Blog post links	Blog posts	404 on blog.fanani.co
Sumopod referral	All content	Wrong referral URL
Content database	All posts	Posts not in database

Thresholds

• mermaid.ink timeout: 8 seconds
• HTTP timeout: 10 seconds
• Sample rate: All mermaid links checked (service is fragile)
• Rate limit: 1 request/0.3s (be polite to servers)

Pre-publish Checklist

Before publishing any tutorial or blog post:

1. Run link-checker on the file
2. Fix any 404s (file moved/deleted)
3. 503s on mermaid.ink are acceptable (service is unstable) — note them
4. Verify Sumopod referral is blog.fanani.co/sumopod
5. Update content database with new post
6. Push to GitHub
7. Rebuild blog

Content Database Integration

Before adding related links to any post, query the content database:

bash skills/content-db/scripts/query.sh search <keyword>

Always link to posts that exist in the database. Never invent URLs.