check-weblinks

/check-weblinks Skill

Check all weblinks in the vault to identify dead or stale links. Part of quarterly vault maintenance.

Usage

/check-weblinks
/check-weblinks --fix    # Also update frontmatter with results

Instructions

This skill uses a sub-agent to check weblinks in parallel for efficiency.

1. Find All Weblinks

Search for all notes with type: Weblink:

grep -l "type: Weblink" *.md

Or use Glob to find weblink files:

• Pattern: Weblink - *.md

2. Launch Sub-Agent for Link Checking

Use the Task tool to spawn a sub-agent with model: "haiku" for efficiency:

Task: Check weblink health
Type: general-purpose
Model: haiku
Prompt: |
  Check the following weblinks and report their status.

  For each weblink:
  1. Read the file to get the URL from frontmatter
  2. Test the URL using curl: `curl -I -L -s -o /dev/null -w "%{http_code}" "<url>"`
  3. Classify the result:
     - 200-299: active
     - 301, 302, 308: redirected (note new URL)
     - 403, 404, 410: dead
     - 500-599: server error (may be temporary)
     - Timeout/error: unreachable

  Return a structured report with:
  - File name
  - URL
  - HTTP status code
  - Classification (active/redirected/dead/error)
  - New URL if redirected

  Files to check:
  [LIST OF WEBLINK FILES]

3. Process Results

Collect results from sub-agent and categorise:

Active (200-299)

• No action needed
• Update lastChecked if --fix flag

Redirected (301, 302, 308)

• Note the redirect target
• Consider updating URL in frontmatter
• Flag for user review

Dead (403, 404, 410)

• Mark as linkStatus: dead
• Candidate for archiving (if not referenced) or deletion

Error (500+, timeout)

• May be temporary
• Recheck before marking dead
• Mark as linkStatus: error

4. Update Frontmatter (if --fix)

For each checked weblink, update frontmatter:

type: Weblink
url: https://example.com/page
linkStatus: active | redirected | dead | error
lastChecked: 2026-01-10
redirectUrl: https://new-url.com  # If redirected