Can it distinguish between minor and critical issues?

Yes, the skill classifies issues by severity, marking broken links in critical files like README or installation guides as 'Critical' while flagging malformed URLs or orphans as 'Minor'.

What types of links can this skill validate?

The skill validates relative file links, internal anchor links (hashes), cross-file anchor links, image references, and HTML-style links within Markdown files.

How does it detect orphaned documentation?

It compares the list of all Markdown files in the repository against all discovered links; files that are not referenced by any other document are flagged as orphaned.

Does it support anchor formatting rules?

Yes, it automatically converts headings to standard anchor formats (lowercase, hyphenated) to verify if the link target actually exists.

Documentation Link Validator

Name: Documentation Link Validator
Author: dykyi-roman

bydykyi-roman

•

学習とドキュメンテーション

Validates and repairs internal documentation links, anchor targets, and orphaned files to ensure documentation integrity.

The Documentation Link Validator is a specialized Claude Code skill designed to maintain the professional quality of your project's technical documentation. It systematically scans Markdown files to detect broken relative paths, missing anchor tags, malformed URLs, and orphaned documents that aren't linked from any navigation or table of contents. By providing a structured validation process and detailed severity reports, this skill helps developers and technical writers ensure that complex documentation suites remain navigable and accurate throughout the development lifecycle.

主な機能

01Identifies orphaned Markdown files missing from project navigation

02Validates internal anchor links against actual document headings

03Flags malformed URLs and unencoded special characters in links

04Detects broken relative links and incorrect file path depths

0545 GitHub stars

06Generates detailed summary reports with critical, major, and minor severity levels

ユースケース

01Automating documentation audits before major software releases

02Verifying link integrity after refactoring project folder structures

03Maintaining navigation consistency in large-scale architectural toolkits

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dykyi-roman/awesome-claude-code check-doc-links

For use in Claude.ai and ChatGPT

Download Skill