Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add thoreinstein/gemini-obsidian --skill link-audit -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/link-audit/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/link-audit/

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

Similar skills

All skills for Notes, tasks and projects →

From the same set15

The whole set →
researcher researcher — a subagent that digs through an Obsidian vault: chains semantic search, full note reads and wikilink hops, then answers with note citations. CX Codex +1 ★ 102repo stars vault Configures or initializes an Obsidian vault for the active agent session via the /vault command. CX Codex +1 ★ 102repo stars research research is a Claude Code skill that searches an Obsidian vault, reads relevant notes, and follows links to answer questions about stored knowledge. CX Codex +1 ★ 102repo stars moc-update moc-update finds the Maps of Content (MOCs) in an Obsidian vault that should link to a freshly created Engineering/ note. Fires on prompts like “update MOC” or “which MOCs”. CX Codex +1 ★ 102repo stars knowledge This skill finds ideas repeated across project notes and drafts a shared note in Engineering/. Use it to turn recurring project knowledge into a linked concept. CX Codex +1 ★ 102repo stars journal journal — a skill for your Obsidian daily note: it reads today's entry, appends quick logs and builds weekly or end-of-day reviews from CLI sessions. CX Codex +1 ★ 102repo stars obsidian-companion obsidian-companion connects your assistant to an Obsidian vault to edit files, inspect broken wikilinks, and run queries using local RAG. CX Codex +1 ★ 102repo stars cross-linker cross-linker finds mentions of other Obsidian notes that lack wikilinks, then sorts possible links by confidence. Use it to connect notes across a chosen folder or a wider vault scope. CX Codex +1 ★ 102repo stars

Project sponsors

Companies that keep this analytics open