Can I use docs.lint.links in my GitHub Actions?

Yes, the skill returns standard exit codes and supports JSON output, making it easy to integrate into CI/CD workflows and pre-commit hooks.

What issues does the autofix feature resolve?

The autofix mode automatically corrects case mismatches and missing or extra .md extensions while preserving anchors and query parameters.

How do I exclude specific directories like node_modules?

The skill excludes common directories by default, but you can add custom patterns using the --exclude parameter.

What types of links can this skill validate?

It validates standard Markdown links, angle bracket URLs, reference-style links, and implicit reference links within .md files.

Does the linter check external websites?

Yes, it can perform HTTP requests to verify external URLs, though you can disable this with the --no-external flag for faster local checks.

Markdown Link Linter

Name: Markdown Link Linter
Author: epieczko

byepieczko

0•

Content Management

Validates and automatically repairs broken internal and external links within Markdown documentation to maintain content integrity.

The docs.lint.links skill is a comprehensive utility for managing documentation quality by identifying dead links across entire repositories. It scans Markdown files to detect broken internal relative paths, case-sensitive file mismatches, and unreachable external URLs, providing both detailed reports and an optional autofix mode. This tool is particularly useful for developers and technical writers who need to ensure their project documentation remains accurate and professional, especially when managing large sets of interconnected files or migrating documentation structures.

Key Features

01Supports directory exclusion and custom search paths

02Autofixes common formatting issues like missing .md extensions

03Generates structured JSON or human-readable text output for CI/CD

040 GitHub stars

05Detects broken internal relative paths and case-sensitive file mismatches

06Verifies external HTTP/HTTPS links with configurable timeouts

Use Cases

01Automating documentation audits within CI/CD pipelines to prevent broken links in production

02Validating external resource links in technical guides to ensure third-party references remain active

03Bulk-fixing case-sensitivity errors and file extension issues across large documentation sites

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add epieczko/betty docs.lint.links

For use in Claude.ai and ChatGPT

Download Skill