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.