skills.rest
usadamasa
usadamasaCOMMUNITY
Explore all skills by this author →
Website𝕏@usadamasaGitHub

restructure-obsidian-vault

Compare Obsidian Vault directories against CLAUDE.md and update documentation.

Updated Aug 27, 2026
Search Tags:#documentation#knowledge management#obsidian#organization#vault#directory structure
One-click install
npx skills add https://github.com/usadamasa/claude-config --skill restructure-obsidian-vault
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: restructure-obsidian-vault
Source: https://github.com/usadamasa/claude-config/tree/main/dotclaude/skills/restructure-obsidian-vault
Command: npx skills add https://github.com/usadamasa/claude-config --skill restructure-obsidian-vault

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you analyze and update your Obsidian Vault's directory structure documentation (CLAUDE.md) to accurately reflect its current state, ensuring your knowledge management system remains organized and up-to-date.

Core Features & Use Cases

  • Vault Analysis: Compares the actual directory structure of your Obsidian Vault against the documented structure in CLAUDE.md.
  • Difference Reporting: Identifies directories that are present in the vault but not documented, or documented but missing from the vault.
  • CLAUDE.md Update: Assists in updating the CLAUDE.md file with the correct directory structure, maintaining a consistent format.
  • Structure Improvement: Offers suggestions for optimizing your vault's organization based on PKM best practices.
  • Use Case: After reorganizing your Obsidian notes, use this skill to automatically detect any discrepancies and update your central documentation, preventing outdated information.

Quick Start

Run the vault analysis script to compare your Obsidian Vault's current directory structure with its CLAUDE.md documentation.

Frequently Asked Questions about restructure-obsidian-vault

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

FAQPage Schema
How do I update my Obsidian vault directory structure documentation automatically?▼

To update your Obsidian vault directory structure documentation, this Skill compares your actual file system layout against documented entries in CLAUDE.md, identifies discrepancies, and facilitates updates to the directory table.

What is the best way to organize an Obsidian vault using PKM best practices?▼

Organizing an Obsidian vault using PKM best practices involves analyzing your current directory structure and applying frameworks like PARA and consistent naming conventions to optimize knowledge management.

Does this vault analysis tool require bash scripting to run?▼

Yes, this vault analysis tool requires bash scripting because it performs file system operations and markdown parsing to detect discrepancies between your actual directories and CLAUDE.md documentation.

Why does my CLAUDE.md directory table show missing folders after reorganizing my Obsidian notes?▼

Your CLAUDE.md directory table shows missing folders because the documentation was not updated after reorganizing your Obsidian notes, creating discrepancies between the documented structure and the actual vault.

Can I detect undocumented directories in my Obsidian vault automatically?▼

You can detect undocumented directories in your Obsidian vault automatically by running a vault analysis script that compares the actual file system layout against the documented entries in CLAUDE.md.

Related Skills

Explore More Content & Communication Skills→
jykimjykim
31

obsidian-links

Format, validate and fix Obsidian wiki links to conform with vault conventions.

Community
Basic
tneztnez

install-git-hooks

Install a Git pre-commit hook that lints staged Markdown files with markdownlint-cli2.

Community
Intermediate
HouseGarofaloHouseGarofalo
3

obsidian

Create and manage Obsidian plugins, Dataview queries, and Templater scripts.

Official
Intermediate
R2W1csR2W1cs
1

bash-linux

Guide Bash/Linux terminal commands and scripting for system administration.

Community
Intermediate