vault-organizer

Organize Obsidian vaults by repairing wikilinks, indexes, and convention violations.

3|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/crypdick/obsidian-knowledge --skill vault-organizer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-organizer
Source: https://github.com/crypdick/obsidian-knowledge/tree/main/plugins/obsidian-knowledge/skills/vault-organizer
Command: npx skills add https://github.com/crypdick/obsidian-knowledge --skill vault-organizer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes scripts (resource) components.

What problem does it solve?

The vault often accumulates broken links, missing indexes, misplaced notes, and convention violations over time, making it harder to trust and navigate.

Core Features & Use Cases

  • Single-pass vault maintenance: audits structure, fixes indexes, triages unresolved issues, and regenerates open-question reports.
  • Deterministic, safety-first updates: avoids editing primary file content and writes state/reporting files consistently.
  • Naming and link recovery: renames ambiguous files, collapses stacked frontmatter problems, and runs controlled broken-link recovery.

Quick Start

Run vault-organizer after you have made substantial vault edits (creating, moving, renaming, deleting) to restore indexes, fix links where possible, and refresh open-questions and needs-attention worklists.

Frequently Asked Questions about vault-organizer

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

FAQPage Schema
How do I fix broken wikilinks in an Obsidian vault?

Fix broken wikilinks in an Obsidian vault by running a safety-first audit that applies deterministic link recovery under conservative, triaged rules. The process repairs unresolved links in a single pass without editing your primary file content.

What is Obsidian vault maintenance and when do I need it?

Obsidian vault maintenance is the process of repairing accumulated structural issues, unresolved links, and convention violations. You need it after substantial vault edits like creating, moving, renaming, or deleting files to restore indexes and refresh open-question worklists.

How do I regenerate indexes for misplaced notes in Obsidian?

Regenerate indexes for misplaced notes in Obsidian by running a single-pass vault audit that updates index and state files. The organizer fixes missing indexes and triages unresolved structural issues while writing only to reporting files.

Does vault-organizer edit my original Obsidian notes during link repair?

Vault-organizer does not edit your original Obsidian notes during link repair. It uses deterministic, safety-first updates that avoid modifying primary file content, writing state and report files consistently to ensure your notes remain untouched.

Do I need Python to run Obsidian vault audits and convention enforcement?

Yes, you need Python3 to run Obsidian vault audits and convention enforcement. The vault-organizer relies on Python3 helper scripts to execute structured audits, rename ambiguous files, and apply controlled broken-link recovery.

Can I schedule automated Obsidian vault gardening with cron?

Yes, you can schedule automated Obsidian vault gardening with cron. The vault-organizer applies its maintenance routines when scheduled cron maintenance runs, executing structured audits and regenerating open-question reports safely.