pkm-vault-master

Analyze Obsidian vaults and generate MOC templates with Python scripts.

54|36|Updated Nov 6, 2025
One-click install
npx skills add https://github.com/oalanicolas/ia --skill pkm-vault-master
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pkm-vault-master
Source: https://github.com/oalanicolas/ia/tree/main/Claude Code/skills/pkm-vault-master
Command: npx skills add https://github.com/oalanicolas/ia --skill pkm-vault-master

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you organize and structure Personal Knowledge Management (PKM) vaults, especially Obsidian vaults following the Linking Your Thinking (LYT) framework. It streamlines vault analysis, link discovery, and MOC generation to reduce friction and cognitive load.

Core Features & Use Cases

  • Vault analysis to identify orphan/hub notes and link patterns
  • Link discovery to surface related notes based on content similarity
  • MOC generation to create structured maps of content from note collections
  • LYT guidance to improve PKM structure and thinking

Quick Start

Use the pkm-vault-master skill to analyze your vault folder with: python scripts/vault_analyzer.py /path/to/vault --detailed

Frequently Asked Questions about pkm-vault-master

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

FAQPage Schema
How do I organize an Obsidian vault using the Linking Your Thinking framework?

Linking Your Thinking (LYT) is a framework for structuring PKM vaults to improve navigation and content discovery. This Skill analyzes your vault, identifies orphan and hub notes, generates MOC (Map of Content) templates across three stages, and provides guidance to enforce LYT principles throughout your vault structure.

What does vault analysis reveal about my note organization?

Vault analysis identifies metrics like orphan notes (isolated from links), hub notes (highly connected), and link density patterns. This reveals which notes lack visibility, which topics act as knowledge hubs, and where gaps in your linking structure exist.

How do I generate a Map of Content (MOC) for my Obsidian vault?

The Skill uses moc_generator.py to automatically create structured MOC templates in three stages, starting from your note collections. MOCs serve as navigation indices that organize related notes hierarchically, reducing friction when exploring your knowledge base.

Can I use this Skill to discover related notes I haven't linked yet?

Yes. The link_finder.py component surfaces related notes based on content similarity, helping you identify connections you may have missed and improve your vault's linking density.

Does this Skill work with non-English vaults?

The Skill supports Portuguese and other content languages while applying LYT principles consistently. Vault analysis and MOC generation function across language boundaries.

What setup do I need before running vault analysis?

You need Python, the requests dependency, and an Obsidian vault folder on your system. The quick start command is: python scripts/vault_analyzer.py /path/to/vault --detailed