zettelkasten-organizer

Analyze and review Obsidian vault notes against Zettelkasten principles.

1|Updated Jul 2, 2026
One-click install
npx skills add https://github.com/tarabakz25/my-skills --skill zettelkasten-organizer-tarabakz25
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: zettelkasten-organizer
Source: https://github.com/tarabakz25/my-skills/tree/main/zettelkasten-organizer
Command: npx skills add https://github.com/tarabakz25/my-skills --skill zettelkasten-organizer-tarabakz25

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Maintaining a healthy Zettelkasten knowledge base in Obsidian is hard at scale: notes become orphaned, links break, frontmatter goes missing, and naming conventions drift. This Skill automates the structural audit of your vault so you can find and fix these issues systematically. ## Core Features & Use Cases - Vault Analysis: Scans all Markdown notes to report note counts, link statistics, orphaned notes, broken links, frontmatter compliance, and tag distribution via analyze_vault.py. - Deep Zettelkasten Review: Runs review_zettelkasten.py to score note quality, identify clusters and hub notes, suggest new connections based on shared tags, and generate prioritized recommendations. - Principle-Guided Fixes: Applies Zettelkasten rules (atomicity, connectivity, unique IDs, progressive elaboration) from the bundled reference guide to categorize issues as critical, important, or optimization opportunities. - Use Case: You have a 300-note Obsidian vault and suspect many notes are disconnected. Run the analysis to get a health report listing 12 orphaned notes and 5 broken links, then receive suggested connections for each orphan based on shared tags. ## Quick Start Ask the agent to review your Zettelkasten vault and report orphaned notes, broken links, and connection suggestions.

Frequently Asked Questions about zettelkasten-organizer

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

FAQPage Schema
How do I find orphaned notes in my Obsidian vault?▼

Run the analyze_vault.py script with the --orphans-only flag to list notes that have no incoming or outgoing links. The script builds a bidirectional link graph from wiki-style and Markdown links, then reports each orphan so you can connect it to related notes.

How to check for broken links in Obsidian notes?▼

The vault analyzer extracts all [[wiki-style]] and Markdown links from each note and matches them against existing files. Any link that resolves to no note is reported as a broken link with its source file, so you can fix or remove it.

Does this work with any Obsidian vault structure?▼

Yes, the scripts scan all Markdown files recursively while excluding the .obsidian configuration folder. However, you should first check your vault's own rules document for naming conventions and required frontmatter fields, since validation is compared against those vault-specific rules.

What are the limitations of automated Zettelkasten review?▼

The analysis covers structure, not content quality or semantic meaning. Connection suggestions are based on shared tags and common neighbors rather than true understanding, and very large vaults over 1000 notes may require performance optimization.

Why does the review script fail to run?▼

The scripts require Python 3 and must be executable; run chmod +x on the scripts if you get permission errors. Also confirm the vault path is correct, since the default is the current working directory.