obsidian-analyzer

Analyze Obsidian vaults for structure, graph connectivity, metadata, and performance.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill analyzes Obsidian vaults to identify structure, graph connectivity, metadata usage, and performance bottlenecks, and provides actionable improvements.

Core Features & Use Cases

  • Vault structure analysis and health checks to surface organization gaps.
  • Graph and metadata audit to identify broken links, orphans, and tag inconsistencies.
  • Performance recommendations covering large files, attachments, and plugin configurations.
  • Use Case: Vault optimization when reorganizing, auditing metadata, or diagnosing slow vaults.

Quick Start

Run the following commands from the vault root after placing SKILL.md at the vault root:

  • python3 scripts/analyze_structure.py <vault_path>
  • python3 scripts/analyze_graph.py <vault_path>
  • python3 scripts/check_performance.py <vault_path>
  • python3 scripts/analyze_metadata.py <vault_path>

Frequently Asked Questions about obsidian-analyzer

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

FAQPage Schema
How do I analyze my Obsidian vault for broken links and orphan notes?

You can diagnose an Obsidian vault for performance bottlenecks by running Python scripts that check large files, attachments, and plugin configurations. The analysis produces a report with prioritized recommendations to optimize slow vaults.

How do I diagnose what is making my Obsidian vault slow?

You can diagnose an Obsidian vault for performance bottlenecks by running Python scripts that check large files, attachments, and plugin configurations. The analysis produces a report with prioritized recommendations to optimize slow vaults.

Can I audit Obsidian metadata and tag inconsistencies across a large vault?

You need an Obsidian vault directory and Python3 with the pyyaml dependency installed. Placing the Skill scripts at the vault root allows you to execute the analysis commands directly from that location.

Do I need Python to check Obsidian vault structure and graph connectivity?

You need an Obsidian vault directory and Python3 with the pyyaml dependency installed. Placing the Skill scripts at the vault root allows you to execute the analysis commands directly from that location.

What is the best way to reorganize an Obsidian vault for better health?

A vault performance check covers large files, excessive attachments, and plugin configurations. The script analyzes these elements to identify what causes slow downs and provides actionable improvements.

What does an Obsidian vault performance check cover?

A vault performance check covers large files, excessive attachments, and plugin configurations. The script analyzes these elements to identify what causes slow downs and provides actionable improvements.