- Home
- Skills
- Code Quality & Review
- Wiki Link Integrity Auditor — Find Broken Markdown Links
Works with the AI Agents you already use
Wiki Link Integrity Auditor — Find Broken Markdown Links
Notes get renamed, merged and deleted, and the links to them stay behind.
$15
Wiki Link Integrity Auditor — Find Broken Markdown Links
Example session with this skill installed
Audit the wiki links in examples/vault and tell me what is broken, what is only a warning, and whether this would pass CI.
- Read your context and instructions
- Compiled the wiki link integrity
I ran the auditor on the bundled example vault (read-only):
$ python3 scripts/wiki_link_auditor.py examples/vault
Wiki Link Audit: 7 pages, 1 attachment, 14 links (3 embeds)
BROKEN Home.md:4 [[Old Plan]] no page named "Old Plan"
BROKEN templates/Template.md:3 [[Placeholder]] no page named "Placeholder"
HEADING Home.md:3 [[Setup#Uninstall]] no heading "Uninstall" in Setup.md
EMBED Home.md:8 ![[missing-chart.png]] no file named "missing-chart.png"
AMBIGUOUS Home.md:5 [[Meetings]] name "Meetings" matches 2 pages
- archive/Meetings.md
- meetings/Meetings.md
ORPHAN Lonely.md no other page links here
ORPHAN templates/Template.md no other page links here
Summary: 2 broken, 1 heading, 1 embed, 1 ambiguous, 2 orphan -> FAIL (fail-on: broken,heading,embed)
Summary
| Kind | Count | Fails CI by default |
|---|---|---|
| BROKEN | 2 | yes |
| HEADING | 1 | yes |
| EMBED | 1 | yes |
| AMBIGUOUS | 1 | no |
| ORPHAN | 2 | no |
The run exits with code 1, so a CI job using the default --fail-on broken,heading,embed would fail.
What to fix first
Home.md:4links to[[Old Plan]], which no longer exists.Home.md:3points at the headingUninstall, which is not inSetup.md.Home.md:8embedsmissing-chart.png, which is not in the vault.Home.md:5links to[[Meetings]], a name shared byarchive/Meetings.mdandmeetings/Meetings.md. Use the full path to pick one.templates/Template.md:3links to[[Placeholder]]. Template placeholders can be skipped with--ignore 'templates/*'.
Next steps
- Add
--ignore 'templates/*'to skip template folders. - Use
--fail-on orphanif you also want orphan pages to fail the check. - Use
--jsonto feed the findings into another tool.
Connects securely to your tools. The creator never sees your data.
About this skill
You renamed a note last month. How many links still point at the old name?
Notes get renamed, merged and deleted, and the links to them stay behind. Heading links break when a heading is reworded, image embeds break when a file moves, two pages end up with the same name, and some pages stop being linked from anywhere. You find out when you need the note.
Wiki Link Integrity Auditor checks all of it in one command.
What it does
- Finds broken
[[links]]with the file and line number of each one - Checks
[[Page#Heading]]links against the headings that really exist in the target page - Checks
![[embeds]]for attachments and embedded notes that are missing - Reports page names shared by several pages and lists the candidates
- Lists orphan pages that no other page links to
- Skips links inside fenced code blocks and
inline code, so code samples do not create noise - Prints text or
--json, skips folders with--ignore GLOB, and--fail-onchooses which kinds make the exit code 1
Honest limits
Only [[wiki links]] are audited (not [text](path.md) links), block reference ids are accepted without checking, and a page name shared by two pages is reported even if your editor would pick one.
What is inside
SKILL.md,README.md,LICENSEscripts/wiki_link_auditor.pytests/test_wiki_link_auditor.py(53 tests)examples/vault/(the vault used in the example)
Requirements and safety
Python 3.8+, macOS or Linux, standard library only. Read-only: it never edits, moves or deletes a file, installs nothing, runs no background service, needs no credentials and makes no network calls.
License
Personal, non-transferable license for your own projects, including commercial work. No resale or redistribution.
Standard Markdown text and web links are ignored. Block references are not verified. Supports only # headings. Requires Python 3.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 5 days ago
Requires