How do I view the results of a link check?

Results are automatically written to a file named '.link-check-results.md' in your workspace root, detailing any broken links or path violations found.

What are path policy violations?

They are rules that flag non-portable paths, such as absolute filesystem paths or excessive 'parent escapes' (../../) that might point outside of your repository.

What does the Link Validation skill do?

It is an automated utility for Claude Code that scans Markdown files for broken links and enforces directory path best practices every time you end a session.

Can I customize which links are ignored or checked?

Yes, you can provide a custom '.lycheerc.toml' file in your project root to override the default validation rules and settings.

Does this skill require external dependencies?

Yes, it requires the 'lychee' link checker to be installed on your system (available via Homebrew) and Python 3.11 or higher.

Markdown Link Validator

Name: Markdown Link Validator
Author: terrylica

byterrylica

•

Content Management

Validates Markdown links and enforces directory path policies automatically at the end of every Claude Code session.

The Link Validation skill ensures the integrity and portability of your project documentation by scanning Markdown files for broken URLs and enforcing strict directory path policies. Utilizing the high-performance lychee engine, it automatically runs during the session-stop hook to detect dead links, forbidden absolute paths, and excessive parent directory traversals. By generating a structured report at the end of your workflow, it helps developers maintain professional-grade documentation and prevents the accidental inclusion of local-only file references.

Key Features

01Automated link checking using the high-performance lychee engine

02Detection of broken external URLs and missing internal file references

03Support for custom configuration via standard .lycheerc.toml files

04Enforcement of path policies to prevent absolute path usage and directory escapes

058 GitHub stars

06Generation of structured Markdown reports with correlation IDs for session review

Use Cases

01Preventing accidental absolute file paths that only function on a local development machine

02Maintaining high-quality documentation standards in large-scale projects within Claude Code

03Ensuring repository documentation is portable and free of broken links before a major release

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add terrylica/cc-skills link-validation

For use in Claude.ai and ChatGPT

Download Skill