link-audit — Claude Code skill: what it does, how to install
link-audit audits Obsidian vaults for broken wikilinks and orphaned notes. Helps repair target paths or generate new links via semantic search.
ISC ★ 102 updated 2026-10-25
npx skills add thoreinstein/gemini-obsidian --skill link-audit -a claude-codeWhat link-audit does
This skill inspects Obsidian vault link integrity through dedicated MCP tools. During the first stage, obsidian_get_broken_links retrieves dead links and groups them by parent document. The assistant then offers to patch incorrect targets via obsidian_replace_in_note or generate stub notes. Edits are never made silently. Every single file change requires manual confirmation.
Next, the skill checks for unlinked files using obsidian_list_notes together with obsidian_get_backlinks. Files residing in Daily Notes/ are bypassed automatically. An optional semantic pass uses obsidian_rag_query with a limit of 5 entries to suggest context-aware [[wikilink]] connections for isolated documents.
Full-vault orphan scans run slowly on large collections. Scoping the command to a specific subfolder keeps inspection fast. If link reporting feels incomplete, run /obsidian:index before executing the audit.
What it helps with
- find broken wikilinks across an Obsidian vault
- detect orphaned notes lacking incoming backlinks
- repair dead link targets via
obsidian_replace_in_note - discover semantic link targets for orphan notes using RAG
Example prompts for the agent
- Audit broken links inside the
Engineering/subfolder - Find orphan notes across the vault while skipping daily logs
- Run vault link health check and generate semantic suggestions
How to install link-audit
1Skills CLI (Vercel)
npx skills add thoreinstein/gemini-obsidian --skill link-audit -a claude-code2Manually: put the files in place
~/.claude/skills/link-audit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/link-audit/
1Skills CLI (Vercel)
npx skills add thoreinstein/gemini-obsidian --skill link-audit -a codex2Manually: put the files in place
.agents/skills/link-audit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add thoreinstein/gemini-obsidian --skill link-audit -a cursor2Manually: put the files in place
.cursor/skills/link-audit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install thoreinstein/gemini-obsidian skills/link-audit2Manually: put the files in place
.github/skills/link-audit/SKILL.md1Skills CLI (Vercel)
npx skills add thoreinstein/gemini-obsidian --skill link-audit -a gemini-cli2Platform CLI
gemini skills install https://github.com/thoreinstein/gemini-obsidian --path skills/link-auditManually: put the files in place
.devin/skills/link-audit/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about link-audit
How to install link-audit in Claude Code?
Run npx skills add thoreinstein/gemini-obsidian --skill link-audit -a claude-code in your terminal.
What does the link-audit skill do?
It scans Obsidian vaults for dead wikilinks and unreferenced notes, prompting you to fix filenames or connect related concepts.
What should I do if broken link results seem incomplete?
Run the /obsidian:index command to update the vault index before launching the link audit.
Source text
SKILL.md · ISC
--- name: link-audit description: >- 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". --- # Vault Link Audit 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
© thoreinstein · ISC · thoreinstein/gemini-obsidian