vault-org

Audit Obsidian vaults, fix broken wiki-links, and update INDEX.md files.

Updated May 10, 2026
One-click install
npx skills add https://github.com/Mateus2411/Hermes-PersonalBot --skill vault-org
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-org
Source: https://github.com/Mateus2411/Hermes-PersonalBot/tree/main/skills/vault-org
Command: npx skills add https://github.com/Mateus2411/Hermes-PersonalBot --skill vault-org

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Organizes and maintains a user’s Obsidian vault by correcting structure, updating INDEX files, and fixing broken wiki-links after moves or migrations.

Core Features & Use Cases

  • Vault Health Audit: Detects empty/legacy directories, duplicate files, INDEX.md count mismatches, and navigation breaks.
  • Reorganization Workflow: Plans phased moves, creates destination folders first, moves notes in batches, fixes wiki-links with multi-pass verification, and updates indexes last.
  • Course Organization Support: Enforces a dual-layer pattern for Courses (light materials) plus knowledge (deep study notes), with consistent naming and cross-linking.

Quick Start

Ask: “reorganize my vault and run a vault health audit, fixing broken wiki-links and updating INDEX.md to match the real folder structure.”

Frequently Asked Questions about vault-org

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

FAQPage Schema
How do I fix broken wiki-links after reorganizing my Obsidian vault?

To fix broken wiki-links after reorganizing your Obsidian vault, you run an iterative repair process with multi-pass verification. This workflow detects navigation breaks, reconciles links, updates INDEX.md counts, and performs a git auto-commit.

What is the best way to clean up duplicate files and empty directories in a knowledge management vault?

The best way to clean up a knowledge management vault is running a vault health audit. This process detects empty or legacy directories, identifies duplicate files, and highlights INDEX.md count mismatches to ensure your structure stays accurate.

How do I reconcile INDEX.md counts with actual files after a migration cleanup?

To reconcile INDEX.md counts with actual files after a migration cleanup, you audit the vault structure. This workflow detects count mismatches, executes phased filesystem moves in batches, and updates indexes last to reflect the real folder structure.

Does vault organization support dual-layer folder structures for course materials and study notes?

Vault organization supports a dual-layer pattern for course materials and study notes. It enforces consistent naming and cross-linking between light course materials and deep knowledge notes, ensuring reliable navigation across both layers.

Can I automate folder moves and index maintenance without breaking existing note navigation?

You can automate folder moves and index maintenance without breaking navigation by using a phased reorganization workflow. This process creates destination folders first, moves notes in batches, and runs iterative wiki-link repair with final index updates.