vault-sweeping

Scan Obsidian vaults for file organization, template compliance, and metadata errors.

2|Updated Nov 4, 2025
One-click install
npx skills add https://github.com/bloknayrb/claudestuff --skill vault-sweeping
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-sweeping
Source: https://github.com/bloknayrb/claudestuff/tree/main/plugins/obsidian-vault-management/skills/vault-sweeping
Command: npx skills add https://github.com/bloknayrb/claudestuff --skill vault-sweeping

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the tedious and error-prone process of maintaining large Obsidian vaults, ensuring data integrity, organization, and discoverability.

Core Features & Use Cases

  • Automated Auditing: Scans for misplaced files, template compliance issues, project status inconsistencies, metadata errors, and cleanup opportunities.
  • Adaptive Performance: Optimizes scan duration based on vault activity (Quick, Standard, Deep paths).
  • Dual-Mode Operation: Leverages Obsidian CLI when available for enhanced accuracy, with robust fallback to file-based detection.
  • Use Case: Run a weekly sweep to automatically identify and report on any files that have drifted out of their designated folders, ensuring your project documentation remains organized and accessible.

Quick Start

Run the vault-sweeping skill to perform a quick check of the vault for critical issues.

Frequently Asked Questions about vault-sweeping

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

FAQPage Schema
How do I automate Obsidian vault maintenance and file organization checks?

Obsidian vault maintenance is automated by scanning for file organization violations, template compliance issues, and metadata errors. The vault-sweeping skill performs comprehensive audits to identify misplaced files and report data integrity issues.

What's the best way to check Obsidian metadata validation and template compliance?

Checking Obsidian metadata validation and template compliance is done by running an automated vault sweep. It scans project status inconsistencies and validates metadata against template rules, flagging cleanup opportunities and reporting violations.

Can I perform a quick scan of my Obsidian vault for critical issues?

You can perform a quick scan of your Obsidian vault using the adaptive path selection feature. It offers Quick, Standard, and Deep scan modes to optimize duration based on vault activity, quickly identifying critical file organization issues.

Does vault maintenance work without the Obsidian CLI installed?

Vault maintenance works without the Obsidian CLI by using a robust fallback file-based detection mode. The skill supports dual-mode execution, leveraging the CLI for enhanced accuracy when available and automatically switching to file scanning otherwise.

What types of data integrity issues are detected during an Obsidian vault sweep?

Data integrity issues detected during an Obsidian vault sweep include file organization violations, template compliance failures, project status inconsistencies, metadata validation errors, and general cleanup opportunities.

When should I run a deep scan versus a standard vault sweep?

You should run a deep scan for comprehensive metadata validation and template compliance checks on large vaults, while standard or quick paths optimize scan duration based on recent vault activity and maintenance frequency.