Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIDeepSeekDeepSeekMuseMuse+22 more

    Wiki Link Integrity Auditor — Find Broken Markdown Links

    1

    Notes get renamed, merged and deleted, and the links to them stay behind.

    $15

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned
    Wiki Link Integrity Auditor — Find Broken Markdown Links

    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

    KindCountFails CI by default
    BROKEN2yes
    HEADING1yes
    EMBED1yes
    AMBIGUOUS1no
    ORPHAN2no

    The run exits with code 1, so a CI job using the default --fail-on broken,heading,embed would fail.

    What to fix first

    1. Home.md:4 links to [[Old Plan]], which no longer exists.
    2. Home.md:3 points at the heading Uninstall, which is not in Setup.md.
    3. Home.md:8 embeds missing-chart.png, which is not in the vault.
    4. Home.md:5 links to [[Meetings]], a name shared by archive/Meetings.md and meetings/Meetings.md. Use the full path to pick one.
    5. templates/Template.md:3 links to [[Placeholder]]. Template placeholders can be skipped with --ignore 'templates/*'.

    Next steps

    • Add --ignore 'templates/*' to skip template folders.
    • Use --fail-on orphan if you also want orphan pages to fail the check.
    • Use --json to 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-on chooses 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, LICENSE
    • scripts/wiki_link_auditor.py
    • tests/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.

    Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Code Quality & Review.

    Standard Markdown text and web links are ignored. Block references are not verified. Supports only # headings. Requires Python 3.

    How to use

    1. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before buying a skill.

    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 4 days ago

    Software
    Python 3.8+

    Permissions

    Terminal / Shell
    Read Files
    Listed4 days ago

    What's inside

    Frequently Asked Questions

    No. It audits any folder of Markdown notes that uses [[wiki links]]: an Obsidian vault, a Logseq graph or a docs folder. It only reads the files and never needs Obsidian to be installed or running.

    Yes, as a command. The script returns exit code 1 when it finds problems of the kinds chosen with --fail-on (default: broken, heading, embed), 2 if the folder does not exist, and can print --json. The package does not include a ready-made GitHub Actions workflow file; you call the script from your own job.

    When a link such as [[Meetings]] matches two or more pages with the same name in different folders, the script reports it as AMBIGUOUS and lists every candidate path under the finding. It does not guess which one you meant. Link with a path such as [[folder/Page]] or rename one page.

    A ZIP with SKILL.md, README.md, LICENSE, scripts/wiki_link_auditor.py (Python standard library only), tests/test_wiki_link_auditor.py (53 tests) and examples/vault/, the small vault used in the example output. It is a personal license for your own projects, including commercial work.

    No. It audits only [[wiki links]] and ![[embeds]]. Ordinary Markdown links like [text](path.md) and web URLs are not checked, and the tool makes no network calls. Block reference ids are accepted without checking.

    New in Code Quality & Review