docs.lint.links

Community

Fix broken docs links, keep content fresh.

Authorepieczko
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Broken links in documentation degrade user experience, reduce trust, and make information inaccessible. Manually checking every link is impractical and time-consuming. This Skill automates the detection and optional autofixing of broken internal and external links in Markdown files.

Core Features & Use Cases

  • Comprehensive Link Validation: Scans for broken internal file paths (including case mismatches, missing/extra extensions) and external HTTP/HTTPS links (404s, timeouts).
  • Autofix Mode: Automatically corrects common internal link issues like case sensitivity and .md extension discrepancies, saving manual correction time.
  • Flexible Exclusion: Exclude specific directories (e.g., node_modules, .git) from scanning to focus on relevant documentation.
  • Use Case: A large documentation repository often accumulates broken links. Integrating docs.lint.links into a CI/CD pipeline ensures that every pull request is checked for broken links, preventing them from reaching production, and can even autofix simple issues.

Quick Start

Check all Markdown files for broken links (skip external for speed)

python skills/docs.lint.links/docs_link_lint.py --no-external

Dependency Matrix

Required Modules

None required

Components

scripts

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: docs.lint.links
Download link: https://github.com/epieczko/betty/archive/main.zip#docs-lint-links

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository