vault-audit

Audit Obsidian vaults across seven phases for structure, links, and frontmatter.

3.4k|343|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/gnekt/My-Brain-Is-Full-Crew --skill vault-audit-gnekt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-audit
Source: https://github.com/gnekt/My-Brain-Is-Full-Crew/tree/main/tests/regression/snapshot/.claude/skills/vault-audit
Command: npx skills add https://github.com/gnekt/My-Brain-Is-Full-Crew --skill vault-audit-gnekt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill performs a comprehensive audit on your Obsidian vault, identifying and addressing issues like structural inconsistencies, duplicates, broken links, and frontmatter inconsistencies, ensuring the health and integrity of your knowledge base.

Core Features & Use Cases

  • Structural Scan: Checks for orphan folders, misplaced files, and missing index files.
  • Duplicate Detection: Identifies and suggests actions for duplicate content.
  • Link Integrity: Validates all wikilinks and suggests fixes for broken ones.
  • Frontmatter Audit: Ensures consistency in YAML frontmatter across all notes.
  • MOC Review: Audits Map of Content files for completeness and accuracy.
  • Cross-Agent Integration: Integrates findings from other agents and generates a health report.
  • Health Report: Provides a detailed summary of the vault's status and trends over time.
  • Automated Fix Suggestions: Offers clear steps for fixing identified issues.
  • Monthly Trend Analysis: Tracks and reports on the vault's health over time.
  • User-Friendly: Offers guidance and suggestions to improve the vault's structure and content.

Quick Start

Run a full audit of your vault by typing 'vault audit'.

Frequently Asked Questions about vault-audit

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

FAQPage Schema
How do I audit my Obsidian vault for broken links and structural issues?

You can check Obsidian vault health by running a comprehensive audit that scans for duplicate content, validates wikilinks, and ensures frontmatter consistency. It generates a detailed health report with automated fix suggestions and monthly trend analysis.

What is the best way to find duplicate notes and fix frontmatter inconsistency in Obsidian?

The best way to find duplicate notes and fix frontmatter inconsistency is a vault audit that detects redundant content and enforces YAML frontmatter consistency across all notes. It provides clear, automated steps to resolve these specific data integrity issues.

Does the vault audit check Map of Content files for accuracy and completeness?

Yes, the vault audit explicitly checks Map of Content (MOC) files for accuracy and completeness. This MOC review phase ensures your knowledge management structure correctly indexes and connects your notes without missing references.

Can I track Obsidian vault health trends over time instead of doing a one-off scan?

You can track Obsidian vault health over time because the audit generates a detailed health report that includes monthly trend analysis. This monitors your knowledge base status over time, integrating findings to highlight ongoing data integrity shifts.

How do I fix orphan folders and missing index files in my knowledge base?

To fix orphan folders and missing index files, run a structural scan during your vault audit. This identifies misplaced files and structural inconsistencies, then offers user-friendly automated fix suggestions to restore your knowledge base architecture.