Correct link resolution and add a step-by-step link fixer

[Dimagidhp]

Purpose

Fixes three link-resolution bugs in the doc validation skill. Also adds fix_links.py to apply a fix plan one group at a time.

Checklist

• llms.txt — N/A, no doc pages in this PR
• Image alt text — N/A, no doc pages in this PR
• Frontmatter — N/A, no doc pages in this PR

Goals

Make "no broken links" mean it, and make applying link fixes reviewable.

Approach

• Resolve links the way mkdocs does; apply fixes one verified group at a time.

Release note

Doc validation skill: corrected link resolution to match mkdocs, added detection of
anchors the build never generates, and added a step-by-step link fixer.

Documentation

SKILL.md and references/conventions.md, in this PR.

Security checks

• Secure coding standards? yes
• FindSecurityBugs? N/A — Python
• No keys, passwords, tokens or secrets? yes

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: fdf94234-7db4-4896-9dfa-2092a97aa531

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[selectiveduplicate]

The regex requires double-quotes to be used, but what if single quotes are used? So it's better to watch out for both.