vault-doctor

Diagnose Obsidian vault backend health with read-only checks.

2|Updated May 13, 2026
One-click install
npx skills add https://github.com/alexherrero/crickets --skill vault-doctor-alexherrero
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-doctor
Source: https://github.com/alexherrero/crickets/tree/main/src/obsidian-vault/skills/vault-doctor
Command: npx skills add https://github.com/alexherrero/crickets --skill vault-doctor-alexherrero

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Diagnose the Obsidian/Google-Drive vault storage backend to ensure the vault_path points to a real MemoryVault and that the backend selection matches what the engine expects, without mutating data.

Core Features & Use Cases

  • Read-only vault health checks that verify vault_path resolution, backend alignment, and absence of unresolved DriveFS conflicts.
  • Detect and surface conflicts (e.g., conflict copies, lost_and_found) for manual triage before they impact recall/recovery.
  • Suitable for pre-session sanity checks on Antigravity or Claude Code, after plugin installation, or during troubleshooting of vault-related issues.

Quick Start

Run vault-doctor to perform a read-only health probe on the active obsidian-vault backend and read the [OK]/[WARN]/[FAIL] report.

Frequently Asked Questions about vault-doctor

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

FAQPage Schema
How do I check Obsidian vault health for Google DriveFS conflicts?

To check Obsidian vault health, run a read-only diagnostic that validates vault_path resolution against a real MemoryVault and scans for unresolved DriveFS conflicts or lost_and_found dumps without mutating data.

What is a read-only vault health check and when do I need one?

A read-only vault health check verifies backend alignment and confirms the vault_path matches the engine's storage selection. You need one before sessions on Antigravity or Claude Code, after plugin installation, or when troubleshooting vault issues.

How do I detect DriveFS conflict copies and lost_and_found files in my vault?

Detect DriveFS conflict copies by running a read-only probe that surfaces conflict files and lost_and_found dumps for manual triage, ensuring they are flagged before impacting recall or recovery operations.

Does the vault health diagnostic modify my vault data or configuration?

No, the vault health diagnostic performs strictly read-only checks via doctor_vault.py, ensuring no mutation of vault data or configuration occurs during the health assessment.

Why does my vault_path not resolve to a real MemoryVault?

Your vault_path may not resolve to a real MemoryVault when the configured backend does not match the engine's storage selection. Run a health check to validate path resolution and backend alignment for diagnosis.