vault-doctor

Name: vault-doctor
Availability: InStock
Author: abhattacherjee

Audit Obsidian vault health and repair issues via JSON reports.

Updated Apr 4, 2026

Search Tags:#obsidian #diagnostics #integrity #vault #repair #dry-run

Ready to run

npx skills add https://github.com/abhattacherjee/obsidian-brain --skill vault-doctor

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: vault-doctor
Source: https://github.com/abhattacherjee/obsidian-brain/tree/main/skills/vault-doctor
Command: npx skills add https://github.com/abhattacherjee/obsidian-brain --skill vault-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Obsidian vaults can accumulate broken backlinks, orphaned notes, and inconsistent metadata that hinder navigation and reliability. Vault-doctor provides automated health checks and safe repair workflows to detect and fix vault integrity issues in a controlled, dry-run first mode.

Core Features & Use Cases

Performs a battery of health checks across vault notes and backlinks to surface integrity problems.
Supports per-project scoping, dry-run mode by default, and interactive application of repairs with /vault-doctor fix.
Use Case: When you notice stale backlinks or mismatched session data, run vault-doctor to audit and repair the vault.

Quick Start

Run /vault-doctor to audit vault health in dry-run mode.

Frequently Asked Questions about vault-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I find and fix broken backlinks and orphaned notes in an Obsidian vault?▼

To find and fix broken backlinks and orphaned notes in an Obsidian vault, run a health check to audit vault integrity. This diagnostic process surfaces stale links and mismatched metadata in a safe dry-run report before applying repairs.

Can I scan and repair vault integrity issues without risking unintended changes to my notes?▼

Yes, you can scan and repair vault integrity issues safely because the audit runs in dry-run mode by default. This reports broken backlinks and inconsistent metadata via JSON without modifying files until you explicitly invoke repair commands.

How do I scope Obsidian vault health checks to a specific project folder?▼

You can scope Obsidian vault health checks to a specific project folder by invoking the diagnostic tool with project filters. This restricts the integrity audit and subsequent repair workflows to only the notes and backlinks within that defined project scope.

What is the best way to automate repairing inconsistent metadata across Obsidian notes?▼

The best way to automate repairing inconsistent metadata across Obsidian notes is to run an automated health check battery that detects integrity problems. You can then interactively apply targeted repairs per-project after reviewing the initial diagnostic report.

Do I need Python installed to run automated vault diagnostics and repairs?▼

Yes, you need Python installed to run automated vault diagnostics and repairs. The audit requires a Python-based dispatcher and modular check scripts to execute its battery of health checks and generate JSON reports for interactive fixing.

Why does my Obsidian vault still show stale links after running a diagnostic dry-run?▼

Your Obsidian vault still shows stale links after a diagnostic dry-run because dry-run mode only audits and reports integrity problems without modifying files. You must explicitly trigger the repair workflow to apply the suggested fixes to the broken backlinks.