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.