Vault Link Audit
Comprehensive audit of link health: broken wikilinks, orphaned notes, and semantic suggestions.
Phase 1 — Broken Links
- Call
obsidian_get_broken_links(optionally withsubfolderargument). - Present broken links grouped by originating file.
- For each, suggest: delete the link, create a stub note, or correct the target name.
- Offer to fix each with
obsidian_replace_in_note(wrong name → correct name).
Phase 2 — Orphaned Notes
- Call
obsidian_list_notesto enumerate all notes in scope. - For each candidate orphan, call
obsidian_get_backlinks. - Notes with zero backlinks AND not in
Daily Notes/are orphan candidates. - Present orphan list with options: link from a relevant note, move to archive, or delete.
Phase 3 — Semantic Suggestions (Optional)
If the user asks for deeper suggestions:
- For each orphan, call
obsidian_rag_querywith the orphan title as query,limit: 5. - If strong matches exist (low distance score), suggest
[[wikilink]]connections.
Arguments
Optional subfolder: /link-audit Engineering/
Tips
- For large vaults, always scope to a subfolder first (Phase 2 on full vault is slow)
- Broken links in
Daily Notes/are usually harmless — offer to skip them - Never make edits without per-change user confirmation
- Run
/indexfirst ifobsidian_get_broken_linksseems incomplete