vault-health

Scan Obsidian Vault notes for broken links, orphan notes, and frontmatter issues.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/robinlllll/claude-code-skills --skill vault-health
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: vault-health
Source: https://github.com/robinlllll/claude-code-skills/tree/main/vault-health
Command: npx skills add https://github.com/robinlllll/claude-code-skills --skill vault-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Vault health checks proactively identify quality issues in a Vault of notes, including broken links, orphaned notes, missing or malformed frontmatter, and empty files, and provide a path to repair them.

Core Features & Use Cases

  • Scan the entire Obsidian Vault (or selected folders) to surface health issues and generate a comprehensive report.
  • Detect and report broken wikilinks, orphan notes, and missing or invalid frontmatter, with actionable remediation steps.
  • Generate per-folder statistics and an overall health score to guide maintenance and audits.

Quick Start

Run /vault-health to perform a full vault quality scan and generate a detailed health report.

Frequently Asked Questions about vault-health

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

FAQPage Schema
How do I find and fix broken wikilinks and orphan notes in an Obsidian vault?▼

To detect and fix broken wikilinks and orphan notes in an Obsidian vault, run a full-vault scan to surface health issues and optionally apply safe auto-fixes with detailed reporting.

How do I check for missing or malformed frontmatter across my notes?▼

Checking for missing or malformed frontmatter involves scanning your vault to enforce presence and structure, generating a comprehensive report that identifies invalid notes and provides actionable remediation steps.

Can I scan a specific folder for vault health issues instead of the entire vault?▼

Yes, you can perform folder-scoped runs to detect vault health issues, generating per-folder statistics and an overall health score to guide targeted maintenance and audits.

What is the best way to clean up empty files and invalid frontmatter in Obsidian?▼

The best way to clean up empty files and invalid frontmatter is running a quality scan that surfaces these issues and optionally applies safe fixes, generating a detailed health report for your vault.

Does the vault health scan automatically repair broken links and missing frontmatter?▼

The vault health scan supports auto-fix of clearly resolvable problems like broken links and missing frontmatter, applying safe repairs while generating a report of all actions taken.

Why do I need a vault health scanner for Obsidian notes?▼

A vault health scanner proactively identifies quality issues like broken links, orphaned notes, and empty files, providing a clear maintenance path and an overall health score to keep your vault organized.