vault-cleanup-auditor

Run four checks on an Obsidian vault and write a dated audit Markdown file.

390|93|Updated Feb 1, 2026
One-click install
npx skills add https://github.com/BrianRWagner/ai-marketing-claude-code-skills --skill vault-cleanup-auditor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-cleanup-auditor
Source: https://github.com/BrianRWagner/ai-marketing-claude-code-skills/tree/main/vault-cleanup-auditor
Command: npx skills add https://github.com/BrianRWagner/ai-marketing-claude-code-skills --skill vault-cleanup-auditor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit your Obsidian vault in Claude Code — finds stale drafts, empty folders, duplicate filenames, and incomplete files. Saves a dated report.

Core Features & Use Cases

  • Runs four targeted checks against your Obsidian vault and saves a prioritized audit report to vault-audit/YYYY-MM-DD-audit.md.
  • Produces a concise, actionable summary to guide vault cleanup and maintenance.
  • Works without external APIs or paid services, ensuring privacy and speed.

Quick Start

Say 'Run the Vault Cleanup Auditor skill against my vault at /path/to/vault' to start.

Frequently Asked Questions about vault-cleanup-auditor

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

FAQPage Schema
How do I audit my Obsidian vault for empty folders and stale drafts?

You can audit your Obsidian vault by running four automated checks that identify stale drafts, incomplete files, duplicate filenames, and empty folders, producing a dated Markdown report for remediation.

What is the best way to find duplicate filenames in Obsidian notes?

Finding duplicate filenames is achieved by running a vault audit check that scans your directory structure and surfaces duplicate filenames alongside empty folders and incomplete files in a consolidated report.

Can I check Obsidian vault health without using external APIs?

Yes, you can check Obsidian vault health without external APIs by using local shell utilities like find, grep, wc, and stat to scan files and generate a Markdown audit report locally without external services.

Does the Obsidian vault cleanup audit work on large note collections?

Yes, the Obsidian vault cleanup audit applies to vaults of any size, using standard shell utilities to scan directories and produce a dated audit file without external service dependencies.

Do I need shell access to run an Obsidian vault audit?

Yes, you need shell access with common utilities like find, grep, wc, stat, and date, plus write access to a vault-audit directory to save the generated Markdown report.

How do I generate a Markdown report for Obsidian vault maintenance?

You generate a Markdown maintenance report by running vault checks that save a dated, prioritized audit file to vault-audit/YYYY-MM-DD-audit.md, summarizing issues for review and remediation.