Add link checker to CI workflow

[mattpodwysocki]

Summary

Adds automated link checking to the CI workflow and sets up git hooks to run all CI checks locally before pushing.

Changes

Link Checking

• Added lychee-action to GitHub Actions workflow
• Created .lycheeignore file to exclude:
  • Localhost URLs
  • Example/placeholder URLs
  • Placeholder tokens (YOUR_TOKEN, etc.)
  • Rate-limited sites (LinkedIn, Twitter)
• Configured retries and timeouts for reliability

Pre-Push Git Hooks

• Added .githooks/pre-push hook that runs all CI checks locally:
  • Prettier formatting validation
  • cspell spell checking
  • markdownlint markdown linting
  • Skills structure validation
• Created scripts/setup-hooks.sh to install hooks automatically
• Updated package.json with setup and postinstall scripts
• Documented setup in CONTRIBUTING.md with usage instructions

Why

Link Checking:
Broken documentation links create poor developer experience. This CI check:

• ✅ Catches broken links before merge
• ✅ Validates external documentation references
• ✅ Ensures examples link to valid resources
• ✅ Prevents link rot over time

Pre-Push Hooks:
Running CI checks locally prevents common CI failures and provides faster feedback:

• ✅ Catches formatting, spelling, and linting issues before push
• ✅ Reduces CI failures and wasted time
• ✅ Provides immediate feedback to developers
• ✅ Runs the exact same checks as CI

Installation

After cloning or pulling this branch, run:

npm install

The postinstall script will automatically set up the git hooks. You can also run manually:

npm run setup

Usage

Automatic (recommended):
The pre-push hook runs automatically before every push.

Manual checks:

npm run check          # Run all checks
npm run format:check   # Check formatting
npm run spellcheck     # Check spelling
npm run lint:markdown  # Lint markdown
npm run validate:skills # Validate skills

Bypass (not recommended):

git push --no-verify

Testing

The link checker and other CI checks will run automatically on this PR.

🤖 Generated with Claude Code