Vault Link Audit
SkillDocs & knowledgeFinds broken wiki-style links, orphaned notes, and weakly connected clusters across an Obsidian vault.
Use Vault Link Audit in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add Vault Link Audit and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use the Vault Link Audit skill
Details
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.
No other account needed.
Add Ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
About this skill
Use when the user wants to audit vault link health, find broken wikilinks, orphaned notes, or semantic clusters. Triggers on "link audit", "broken links", "link health", "graph cleanup", or "find orphans".
What this skill tells your AI
The instructions your AI receives, as published by thoreinstein/gemini-obsidian in skills/link-audit/SKILL.md and read by Ahel’s review.
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, suggest
[[wikilink]]connections.
Arguments
Optional subfolder: /link-audit Engineering/
Tips
- For large vaults, always scope to a subfolder first; a full-vault orphan scan is slow
- Broken links in
Daily Notes/are usually harmless; offer to skip them - Never make edits without per-change user confirmation
- Run
/obsidian:indexfirst ifobsidian_get_broken_linksseems incomplete
Signals
- GitHub stars
- 102
- Forks
- 9
- Last commit
- Jul 2026
Advanced
- Item type
- skill
- Key
link-audit- Source
- github.com/thoreinstein/gemini-obsidian
github.com/thoreinstein/gemini-obsidian
More in Docs & knowledge
Skill · mattpocock
More in Docs & knowledgecanvas-design
Skill · anthropics
More in Docs & knowledgedoc-coauthoring
Skill · anthropics
More in Docs & knowledgepopups
Skill · coreyhaines31
More in Docs & knowledgewriting-for-agents
Skill · mattpocock
More in Docs & knowledgespec-driven-development
Skill · addyosmani
More in Docs & knowledge