doc-verifier

Doc Verifier

Catches documentation rot before users hit it. Validates everything: code examples actually run, links resolve, API docs match reality, CLI flags exist, and docs stay fresh.

Scripts: ${CLAUDE_SKILLS_DIR:-$HOME/.claude-agent/.claude/skills}/doc-verifier/scripts/ Binary: ~/bin/doc-verifier

Quick Reference

S=${CLAUDE_SKILLS_DIR:-$HOME/.claude-agent/.claude/skills}/doc-verifier/scripts

# Full review of a project
doc-verifier ~/my-project

# Quick check (links + freshness only)
doc-verifier ~/my-project --quick

# Full audit including code execution
doc-verifier ~/my-project --full

# With API comparison
doc-verifier ~/my-project --api-url http://localhost:3000

# With CLI comparison
doc-verifier ~/my-project --cli-cmd "node ~/my-project/cli.js"

# Output to separate directory
doc-verifier ~/my-project --output-dir /tmp/doc-review

# JSON format
doc-verifier ~/my-project --format json

# Compare with previous review
doc-verifier ~/my-project --compare /tmp/previous-review

# Individual scripts
node $S/links.cjs ~/my-project
node $S/freshness.cjs ~/my-project
node $S/completeness.cjs ~/my-project
node $S/examples.cjs ~/my-project
node $S/api-docs.cjs ~/my-project --api-url http://localhost:3000
node $S/cli-docs.cjs ~/my-project --cli-cmd "mycli"
node $S/report.cjs /tmp/output-dir --format md

Scripts

1. examples.cjs — Code Example Validator

Extracts fenced code blocks from markdown and executes them:

• bash/sh: Runs commands, checks exit codes. Skips dangerous commands (rm, drop, delete).
• js/javascript: Writes to temp file, runs with Node. Checks syntax/runtime errors.
• python: Writes to temp file, runs with python3.
• Skips blocks marked <!-- skip-verify --> or data blocks (text, json, yaml, etc.)
• Output: examples-report.json

2. links.cjs — Link Checker

• External URLs: HEAD request, checks status codes
• Internal links: verifies file exists
• Anchor links: verifies heading exists
• Cross-file anchors: verifies both file and heading
• Image references: verifies image exists
• Rate limited (5 req/sec), configurable timeout/retries
• Output: links-report.json