doctruth-linkslisted
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