vault-health

Audit an Obsidian vault for orphan notes, broken wikilinks, stubs, and stale content.

2|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/DoctorMozg/claude-pipelines --skill vault-health-doctormozg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-health
Source: https://github.com/DoctorMozg/claude-pipelines/tree/main/plugins/mz-knowledge/skills/vault-health
Command: npx skills add https://github.com/DoctorMozg/claude-pipelines --skill vault-health-doctormozg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Obsidian vaults accumulate orphan notes, broken wikilinks, stub notes, and stale content over time, and without a periodic audit these issues silently degrade the knowledge base. This Skill runs a structured health check and writes a dated audit note to the vault root so problems are tracked across weeks. ## Core Features & Use Cases - Five health checks: Detects orphan notes (zero backlinks), broken wikilinks, stub notes (<100 words with no outlinks), stale notes (>90 days unmodified), and tag inconsistencies including singleton tags. - CLI with fallback: Uses the official obsidian CLI when available and falls back to file scanning via Bash/Glob/Grep when it is not. - Approval-gated reporting: Presents findings for explicit user approval before writing a _vault_audit_YYYY-MM-DD.md note to the vault root. - Use Case: Run a weekly vault maintenance pass after a large import of notes to surface orphans and broken links before they compound. ## Quick Start Run a vault health audit on my Obsidian vault and write the findings report to the vault root.

Frequently Asked Questions about vault-health

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

FAQPage Schema
How do I find orphan notes in an Obsidian vault?

Orphan notes are notes with zero backlinks from other notes. This audit detects them using the `obsidian orphans` CLI command when available, or by scanning all markdown files for wikilinks, and lists up to 20 orphans with path and word count.

How to detect broken wikilinks in Obsidian?

Broken wikilinks are links that do not resolve to an existing file. The audit uses `obsidian unresolved` when the CLI is present, otherwise it scans note content for wikilink targets and checks each against the vault's file list.

Does the vault audit work without the Obsidian CLI installed?

Yes, the audit falls back to file scanning via Bash, Glob, and Grep when the obsidian CLI is unavailable. The fallback is recorded in the task state file, and all five health checks still run.

What counts as a stub note or stale note in a vault audit?

A stub note has fewer than 100 words, zero outgoing wikilinks, and an mtime older than 30 days. A stale note has not been modified in over 90 days and has zero outgoing wikilinks.

Does the vault health audit fix the issues it finds?

No, the audit only inventories health issues and writes a report note after user approval. Fixing orphans, links, or stubs is delegated to separate skills such as process-notes or vault-connect, since auto-fixing risks data loss.