atlasmd-docs-link-checker

Validates and fixes broken links and anchors in AtlasMD markdown documentation.

Updated Aug 4, 2026
One-click install
npx skills add https://github.com/joaomcarlos/AtlasMD --skill atlasmd-docs-link-checker-joaomcarlos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: atlasmd-docs-link-checker
Source: https://github.com/joaomcarlos/AtlasMD/tree/main/ai/skills/atlasmd-docs-link-checker
Command: npx skills add https://github.com/joaomcarlos/AtlasMD --skill atlasmd-docs-link-checker-joaomcarlos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Documentation links break silently as pages are renamed, moved, or restructured, leaving readers hitting dead ends. This Skill scans every markdown file in an AtlasMD documentation project, verifies that internal links and heading anchors resolve to real targets, and automatically normalizes link formatting before validation. ## Core Features & Use Cases - Link Fixing: Normalizes anchor fragments, strips redundant site-base prefixes, and corrects heading numbering format across all markdown files. - Broken Link Detection: Resolves every link against a filesystem-based site index, reporting missing pages, missing anchors, and unreachable targets with file, line, and section context. - Use Case: After renaming a documentation section, run the fixer then the checker against your content directory to get a precise list of every link that now points to a non-existent page or anchor, so you can repair them before publishing. ## Quick Start Ask the AI to run the link fixer and then the broken-link checker against your documentation content directory and report any broken links it finds.

Frequently Asked Questions about atlasmd-docs-link-checker

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check for broken links in markdown documentation?

Run the check-broken-links.py script with uv, passing --docs-root pointing at your content directory. It scans all markdown files, resolves each link against a site index, and reports failures with file, line number, and section context.

How do I fix broken markdown links automatically?

Run fix-common-links.py before checking. It normalizes anchor fragments, strips redundant site-base prefixes from internal links, and fixes heading numbering format, which eliminates most false positives before validation.

Does the link checker require a running dev server?

No, the checker performs filesystem-based validation by default, building a site index from your markdown files. A running dev server only enables an optional HTTP fallback pass that filters false failures caused by redirects.

Can the checker validate external links?

External http(s) link checking is disabled by default. Pass the --include-external flag to enable it, and adjust --concurrency and --timeout to control request parallelism and per-request timeouts.

Why does the checker report anchor-not-found errors?

The target page exists but the heading anchor does not match. Anchors are derived from heading text with normalization rules like lowercasing and underscore-to-dash conversion, so run the fixer first or update the anchor to match the actual heading.