← ClaudeAtlas

doctruth-linkslisted

Finds links, images and anchors in Markdown (plus basic reStructuredText and AsciiDoc) that no longer point at anything: missing files, wrong letter case, headings that were renamed, empty or TODO targets, http links, localhost links and docs that nothing links to. Offline by default; external URLs are checked only with --online. Then fixes each one with the smallest edit and never invents a URL. Use when the user says "check the links in my README", "find broken links", "my anchors are broken", "which docs are orphaned", "fix the dead links", or "I moved some files, what links broke".
vivekbhange-hub/docs-truth-skill · ★ 0 · Data & Documents · score 75
Install: claude install-skill vivekbhange-hub/docs-truth-skill
# doctruth-links: links that still go somewhere A README link is a promise that a page exists. `link_check.py` reads every doc, skips code fences and inline code, and checks each link against the real directory listing and the real headings. Your job is to turn its findings into small, correct edits. ## Inputs - A project folder (default: the current one) or a single doc file. - Optional: `--online` to also check external `http(s)` links. This sends requests to third-party servers, so ask first when the repository is private or the user did not mention it. - Commands below say `python3`; on Windows use `python` (or `py -3`). ## Outputs - A findings table (rule, severity, `file:line`, section, problem, suggestion). - A patch for each fixable finding, as the smallest edit, and a list of the ones that need a human decision (a link whose target was deleted on purpose). - A re-run of the script showing the findings gone. ## Steps 1. **Confirm permission.** Read and edit docs only in a repository the user owns or is authorized to change. Do not use `--online` against a list of URLs the user did not ask you to check. 2. **Run the offline check.** ``` python3 "${CLAUDE_SKILL_DIR}/link_check.py" . --json > doctruth-links.json python3 "${CLAUDE_SKILL_DIR}/link_check.py" . ``` Add `--fail-on high` in CI so a broken link fails the build. `--exclude 'vendor/*'` skips folders; `--entry 'docs/api/*.md'` marks docs that are reached some other way. 3. **Fix i