link-validation

Universal link validation using lychee for Claude Code sessions. Runs at session end to detect broken links and path policy violations.

⭐4stars🔀0forks📁View on GitHub🕐Updated Jan 4, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill automates link validation and path policy enforcement within your workspace using the lychee engine. It ensures documentation integrity by detecting broken URLs and preventing security risks like excessive path traversal or absolute path leaks during Claude Code sessions, providing a comprehensive quality assurance check for markdown-heavy projects.

Use Cases

  • Documentation Maintenance: Automatically verify all external and internal links in Markdown files before committing changes to ensure a seamless user experience and prevent 404 errors.
  • Security and Compliance: Enforce strict path policy rules to prevent the inclusion of absolute filesystem paths or dangerous parent directory escapes in repository files.
  • Automated Technical Writing QA: Streamline the editing process by integrating link checking into the development workflow, catching broken references in READMEs and documentation at the end of every coding session.
namelink-validation
descriptionUniversal link validation using lychee for Claude Code sessions. Runs at session end to detect broken links and path policy violations.

Link Validation Skill

Validates markdown links in your workspace using lychee.

What It Does

At session end (Stop hook), this skill:

  1. Discovers all markdown files in your workspace
  2. Runs lychee to check for broken links
  3. Lints paths for policy violations (absolute paths, excessive traversal)
  4. Outputs JSON results for programmatic consumption

Requirements

  • lychee installed (brew install lychee)
  • Python 3.11+ and uv

Output

Results are written to .link-check-results.md in your workspace:

# Link Check Results

**Correlation ID**: `01JEGQXV8KHTNF3YD8G7ZC9XYK`

## Lychee Link Validation

No broken links found.

## Path Policy Violations

No path violations found.

Path Policy Rules

Rule Severity Description
NO_ABSOLUTE_PATHS Error Filesystem absolute paths not allowed
NO_PARENT_ESCAPES Warning Excessive ../ may escape repository
MARKETPLACE_RELATIVE Warning Plugins should use ./ relative paths

Configuration

Override the default lychee config by placing .lycheerc.toml in your workspace root.

See config/lychee.toml for the default configuration.

References