Vault Maintenance

Run comprehensive health checks on the Obsidian vault — orphan notes, stale drafts, broken links, type mismatches. Triggers: "vault maintenance", "check vault health", "find orphan notes", "audit my vault", "what needs fixing". Only runs when explicitly requested.

seanGSISG f01d024 1.4 KB Updated

File contents

Vault Maintenance

Scan the vault for structural issues and report findings with actionable fixes. Use Grep and Glob for efficiency — avoid reading files fully when a frontmatter scan suffices.

Checks

1. Orphan notes

Notes in Notes/*/ missing type or tags frontmatter. These won't appear in Bases views.

2. Stale drafts

Notes with status: draft where created is 30+ days old. Finish or archive.

3. Duplicate detection

Notes with very similar titles (case-insensitive). Flag pairs for review.

4. Invalid types

Notes with a type value not in CLAUDE.md's valid types.

5. Subfolder mismatch

Notes where the subfolder name doesn't match the type frontmatter field (e.g., file in Notes/config/ with type: reference). Fix by moving the file or updating the type.

6. Broken wikilinks

[[...]] links that don't resolve to any vault file.

7. Inbox status

Count unprocessed files in Inbox/.

Report format

Structured report with counts per check, specific items found, summary. After report, offer to fix: use Edit for frontmatter fixes, Bash mv to relocate misplaced files.

seanGSISG/claude-depot/tree/main/plugins/vault-tools/skills/vault-maintenance commit f01d024346

Frequently asked questions

npx skillmds@latest add seangsisg/vault-maintenance