link-validation

terrylica 的头像作者 terrylica

使用lychee在Claude Code会话中进行通用链接验证。在会话结束时运行,以检测断链和路径策略违规。

📖 中文导读:使用lychee在Claude Code会话中进行通用链接验证。在会话结束时运行,以检测断链和路径策略违规。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

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