defrag

Audit and defragment Obsidian vaults with a 5-phase structural process.

14|1|Updated Jun 4, 2026
One-click install
npx skills add https://github.com/galeka/GAIA-Obsidian-Vault --skill defrag-galeka
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: defrag
Source: https://github.com/galeka/GAIA-Obsidian-Vault/tree/main/tests/regression/snapshot/.claude/skills/defrag
Command: npx skills add https://github.com/galeka/GAIA-Obsidian-Vault --skill defrag-galeka

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill ensures the structural integrity and efficiency of your Obsidian vault through regular defragmentation and maintenance, addressing potential issues with organization and data accessibility.

Core Features & Use Cases

  • Structural Audit: Runs a 5-phase audit of your vault, checking for incomplete areas, outdated projects, inconsistent tags, and other structural issues.
  • Inbox Hygiene: Ensures old items in the inbox are sorted appropriately, maintaining a clean and manageable inbox.
  • Tag Management: Consolidates tag taxonomy, removing unused tags and managing synonyms for consistency.
  • Master Index: Updates and verifies the Master Index for accurate linking and navigation within the vault.
  • Custom Area Scaffolding: Automatically creates structure for new areas identified during the audit process.

Quick Start

Activate the defrag skill by saying 'defragment the vault' or 'run weekly defrag'.

Frequently Asked Questions about defrag

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

FAQPage Schema
How do I perform structural maintenance on an Obsidian vault?

Vault maintenance involves running a 5-phase audit to check inbox items, tags, MOCs, and projects, ensuring organization and accessibility. You can trigger this by saying 'run weekly defrag'.

What is the best way to consolidate tags and manage synonyms in Obsidian?

Consolidating tag taxonomy requires a structural audit that removes unused tags and manages synonyms for consistency. This ensures your vault remains organized and easy to navigate.

How do I keep my Obsidian inbox from accumulating unsorted notes?

Inbox hygiene is maintained by auditing old items and ensuring they are sorted appropriately into areas, projects, or resources. This keeps your inbox clean and manageable.

Does vault defragmentation require a specific folder structure?

Yes, defragmentation requires existing vault mapping and monitors specific structures including inbox, tags, MOCs, areas, projects, resources, and templates to function properly.

How does a Master Index improve Obsidian vault navigation?

Updating the Master Index verifies accurate linking and navigation within the vault. It is refreshed during the structural audit to reflect any newly created areas or consolidated tags.

Can I automate scaffolding for new areas in my Obsidian vault?

Yes, custom area scaffolding automatically creates structure for new areas identified during the audit process. This ensures new content is immediately organized within the vault.