obsidian-organizer

What This Skill Does

The obsidian-organizer skill acts as an automated architect for your Obsidian knowledge base. Its primary function is to transform cluttered, sprawling, or disorganized personal knowledge management (PKM) systems into structured, maintainable, and highly searchable digital libraries. It accomplishes this by enforcing consistent folder hierarchies, normalizing file naming conventions, identifying redundant or orphaned notes, and ensuring that your vault adheres to professional-grade knowledge management standards. By utilizing a staged approach—which includes auditing, dry-run simulation, and systematic migration—it ensures that your vault remains intact and logically sound throughout the organization process.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal or command interface:

clawhub install openclaw/skills/skills/asimons81/obsidian-organizer

Ensure that you have appropriate file system read/write permissions for the specific Obsidian vault path you intend to organize, as the skill requires access to read your metadata and write standardized file changes.

Use Cases

• Vault Rejuvenation: Perfect for users who have accumulated hundreds of notes over months or years and now face significant 'note rot' or discovery friction.
• Standardization: Ideal for teams or researchers who need to enforce a specific schema across multiple collaborative vaults.
• Migrating Data: Use this when importing notes from external tools like Evernote, Notion, or Roam to ensure that incoming data is instantly mapped to your preferred folder structure and naming conventions.
• Maintenance Workflows: Best for performing quarterly health checks on your vault to clean up unused assets, consolidate duplicate tags, and archive outdated project folders.

Example Prompts

1. "I've been dumping everything into my root folder for months. Please scan my vault and suggest a standard 3-level folder structure based on my content themes."
2. "Run the obsidian-organizer audit on my vault located at ~/Documents/SecondBrain and show me the list of files that violate my naming conventions before applying any changes."
3. "I have a massive backlog of notes in my 'Inbox' folder. Can you run the migration checklist and help me sort these into their proper categories based on my existing file structure?"

Tips & Limitations

• Safety First: Always review the dry-run output. The tool is designed to be deterministic, but your specific content needs might require manual overrides.
• Shallow Hierarchy: This skill performs best when maintaining a folder depth of three levels or less, which prevents 'folder fatigue' and improves navigation speed.
• Human-in-the-Loop: While the tool automates the heavy lifting, it cannot determine the 'intent' of a note. If you are unsure about the classification of a specific file, always choose to pause and verify rather than performing a bulk move. The tool is strictly designed to not delete notes automatically, so rest assured your data remains safe throughout the process.