permanent-rebuilder

Reorganize Obsidian permanent notes into hub/leaf/MOC taxonomy with dry-run plans.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/atman-33/skills --skill permanent-rebuilder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: permanent-rebuilder
Source: https://github.com/atman-33/skills/tree/main/skills/obsidian/permanent-rebuilder
Command: npx skills add https://github.com/atman-33/skills --skill permanent-rebuilder

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you transform a sprawling permanent knowledge base into a durable, well-structured vault by establishing a repeatable hub/leaf/MOC taxonomy, enforcing required metadata (notably summary) and a standardized frontmatter template, and planning non-destructive reorganizations.

Core Features & Use Cases

  • Plan and design the hub/leaf/MOC structure and tag taxonomy to improve findability and navigation within the permanent folder.
  • Non-destructive moves: generate a safe, dry-run plan that moves files into 10_hub/20_leaf and 90_meta while preserving existing links.
  • Metadata enforcement: ensure every note has a summary, created date, and status, with guided templates for hub/leaf/MOC notes.
  • MOC maintenance: update navigation graphs and references to reflect reorganized structure.

Quick Start

Use the permanent-rebuilder skill to generate a dry-run restructure plan for permanent/ and review before applying moves.

Frequently Asked Questions about permanent-rebuilder

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

FAQPage Schema
How do I reorganize an Obsidian vault into a hub and leaf structure without breaking links?

To reorganize an Obsidian vault into a hub and leaf structure without breaking links, use a non-destructive dry-run restructure plan that moves files while preserving existing connections. The permanent-rebuilder skill generates this plan to safely reorganize permanent notes into 10_hub, 20_leaf, and 90_meta folders.

How do I standardize frontmatter and enforce metadata across permanent notes in Obsidian?

Standardizing frontmatter and enforcing metadata across permanent notes in Obsidian requires applying a guided template that ensures every file has a summary, created date, and status. This skill enforces required metadata and a standardized frontmatter template to maintain consistency across your knowledge base.

What is the best way to maintain MOC navigation graphs when restructuring an Obsidian vault?

The best way to maintain MOC navigation graphs when restructuring an Obsidian vault is to update navigation references to reflect the reorganized hub and leaf structure. This skill updates MOC navigation graphs and references automatically after files are moved into their new taxonomy.

Can I preview changes before applying moves to my Obsidian permanent folder?

Yes, you can preview changes before applying moves to your Obsidian permanent folder by generating a safe dry-run restructure plan. This allows you to review exactly how files will be reorganized into the hub, leaf, and MOC taxonomy before any modifications are executed.

Do I need Python scripts to restructure an Obsidian permanent vault?

Yes, you need supporting Python scripts to restructure an Obsidian permanent vault. The process requires scan_permanent_notes.py, build_restructure_plan.py, and apply_restructure_plan.py to scan existing notes, generate a safe reorganization plan, and execute the non-destructive file moves.

Why does my Obsidian knowledge base need a tag taxonomy and standardized permanent notes?

Your Obsidian knowledge base needs a tag taxonomy and standardized permanent notes to improve findability and navigation within long-term storage. Establishing a repeatable hub, leaf, and MOC structure transforms a sprawling knowledge base into a durable, well-structured vault.