vault-graph

Analyze Obsidian vault wikilink structure to detect orphans and missing notes.

36|2|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/tuan3w/obsidian-vault-agent --skill vault-graph
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vault-graph
Source: https://github.com/tuan3w/obsidian-vault-agent/tree/main/skills/vault-graph
Command: npx skills add https://github.com/tuan3w/obsidian-vault-agent --skill vault-graph

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

It helps you diagnose fragmentation in your Obsidian vault by exposing structural issues like orphans, bridge concepts, missing links, and overall graph health.

Core Features & Use Cases

  • Vault structure graph analysis: Computes link structure as a directed graph and derives metrics like PageRank and betweenness to find influential and bridge notes.
  • Orphan and dead-end detection: Identifies notes with zero in/out links and notes that are referenced but never link onward.
  • Missing-link discovery: Detects wikilinks that point to non-existent notes so you can decide what to create and where it matters.
  • Actionable interpretation via agent: Uses an agent to turn metrics into prioritized, concrete recommendations referencing specific note names.

Quick Start

Run vault-graph to analyze your vault’s wikilink network by executing the command that invokes analyze_vault_graph.py on your vault root directory.

Frequently Asked Questions about vault-graph

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

FAQPage Schema
How do I find orphan notes and missing links in my Obsidian vault?

To find orphan notes and missing links in an Obsidian vault, you can run a graph analysis script that computes wikilink structures to identify notes with zero connections and detect references pointing to non-existent notes.

What is vault network analysis and how does it work for knowledge graphs?

Vault network analysis models your notes as a directed graph to compute metrics like PageRank and betweenness. This reveals influential notes and bridge concepts, exposing the overall knowledge graph health and structural fragmentation.

Can I use networkx to map dead ends and bridge concepts in my notes?

Yes, you can use networkx to map dead ends and bridge concepts by extracting the wikilink structure of your notes into a directed graph and calculating betweenness centrality to find highly connected bridge notes.

How do I get actionable linking recommendations from a vault graph?

You get actionable linking recommendations from a vault graph by running a deterministic metric computation over the vault structure, then using an agent to interpret the JSON results into prioritized suggestions referencing specific note names.

Does vault graph analysis search note content or only map link structures?

Vault graph analysis only maps link structures for structural discovery. It computes metrics over the wikilink network to identify orphans and missing notes, rather than searching or parsing the actual text content within the notes.