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.