obsidian-lint

Audit Obsidian vault filesystem layout and propose rule-based file moves.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/cosmicdreams/claude-plugins --skill obsidian-lint-cosmicdreams
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-lint
Source: https://github.com/cosmicdreams/claude-plugins/tree/main/workflow/skills/obsidian-lint
Command: npx skills add https://github.com/cosmicdreams/claude-plugins --skill obsidian-lint-cosmicdreams

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It prevents Obsidian vaults from drifting into an inconsistent, hard-to-maintain folder and file layout by auditing a vault against shared naming and structure rules and proposing safe corrections.

Core Features & Use Cases

  • Vault structure auditing: Detects misplaced markdown files in the vault root and flags empty folders.
  • Rules-driven reorganization: Proposes destination paths according to obsidian-rules.md, including cleaning up legacy shared/ prefixes and naming that violates conventions.
  • Dry-run by default: Produces a preview of proposed moves before applying changes, letting you confirm or edit per violation.

Quick Start

Ask: "lint my vault and fix vault structure using the rules file in the plugin references."

Frequently Asked Questions about obsidian-lint

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

FAQPage Schema
How do I fix my Obsidian vault structure when notes are misplaced in the root folder?

To fix your Obsidian vault structure, this Skill audits the filesystem layout to identify misplaced markdown files in the vault root and empty directories. It generates a rules-based dry-run plan, allowing you to review and confirm proposed corrections before applying any file moves.

What is the best way to clean up empty directories and legacy folder prefixes in an Obsidian vault?

The best way to clean up empty directories and legacy shared/ prefixes is by running a rules-driven filesystem audit. The Skill flags these structural violations and proposes a reorganization plan based on your defined naming and folder conventions.

How do I safely reorganize markdown files without accidentally losing data during a vault audit?

You can safely reorganize markdown files because the Skill operates as a dry-run by default. It produces a preview of proposed moves from the rules file and only executes the changes after you provide explicit confirmation for each violation.

Can I use a custom rules file to validate naming conventions across my Obsidian vault?

Yes, you can validate naming conventions using a custom rules file. The Skill generates its dry-run refactor plan by reading the rules defined in references/obsidian-rules.md to determine the correct destination paths for your files.

Does the Obsidian vault linter apply changes automatically when it finds inconsistent folder structures?

No, the Obsidian vault linter does not apply changes automatically. It scans the vault root to detect ad-hoc notes and inconsistent structures, then produces a preview of proposed moves that requires your explicit confirmation before moving any files.