Vault Link Audit

SkillDocs & knowledge

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".

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Vault Link Audit skill

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

  1. Call obsidian_get_broken_links (optionally with subfolder argument).
  2. Present broken links grouped by originating file.
  3. For each, suggest: delete the link, create a stub note, or correct the target name.
  4. Offer to fix each with obsidian_replace_in_note (wrong name → correct name).

Phase 2 — Orphaned Notes

  1. Call obsidian_list_notes to enumerate all notes in scope.
  2. For each candidate orphan, call obsidian_get_backlinks.
  3. Notes with zero backlinks and not in Daily Notes/ are orphan candidates.
  4. 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:

  1. For each orphan, call obsidian_rag_query with the orphan title as query, limit: 5.
  2. 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:index first if obsidian_get_broken_links seems incomplete

Signals

GitHub stars
102
Forks
9
Last commit
Jul 2026
Advanced
Item type
skill
Key
link-audit
Source
github.com/thoreinstein/gemini-obsidian