obsidian-vault-linker

Discover and write typed relationships between Obsidian notes with YAML frontmatter.

74|7|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/penfieldlabs/obsidian-wikilink-types --skill obsidian-vault-linker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-vault-linker
Source: https://github.com/penfieldlabs/obsidian-wikilink-types/tree/main/skill
Command: npx skills add https://github.com/penfieldlabs/obsidian-wikilink-types --skill obsidian-vault-linker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you uncover and document meaningful relationships between notes in an Obsidian vault, storing them as readable Markdown plus YAML frontmatter without requiring additional plugins.

Core Features & Use Cases

  • Vault discovery and triage: Find relevant notes by folders/tags/topics using Obsidian CLI when available, or direct file reading from disk when not.
  • Evidence-based relationship identification: Detect contradictions, supersessions, causal chains, and cross-domain connections using strict, quote-backed analysis.
  • Approval-first writing with validation: Produce a reviewable relationship plan, then write only after approval (or in autonomous mode), ensuring frontmatter keys, inline typed links, and targets remain consistent.

Quick Start

Ask an AI to: examine your vault for contradictions and supersessions around a topic, then present only high-confidence relationship findings with quoted evidence and wait for approval before writing any YAML updates.

Frequently Asked Questions about obsidian-vault-linker

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

FAQPage Schema
How do I discover and document contradictions between Obsidian notes?

To discover contradictions in Obsidian notes, the Skill reads vault contents and frontmatter to identify conflicting evidence, then proposes typed relationships with quoted evidence for your approval before writing YAML updates. It ensures knowledge graph consistency by using matching YAML keys and inline aliases.

Can I write typed knowledge relationships in Obsidian without extra plugins?

Yes, you can write typed knowledge relationships without plugins by storing them as readable Markdown wikilinks and YAML frontmatter. It ensures dataview compatibility through matching inline @type aliases and frontmatter keys.

What is evidence-based linking for a knowledge graph?

Evidence-based linking for a knowledge graph is the process of proposing note relationships using strict, quote-backed analysis to establish high or medium confidence connections, ensuring every link is verifiable against the original text.

Does this approach work with existing YAML frontmatter and dataview setups?

Yes, it works with existing YAML frontmatter and dataview setups by writing approved updates with matching YAML keys and inline @type aliases, ensuring new relationship data integrates seamlessly without breaking current queries.

How do I map causal chains and knowledge evolution across vault folders?

You can map causal chains and knowledge evolution across folders by using vault discovery to find relevant notes by tags or topics, then applying typed relationship proposals to document supersessions and cross-domain connections.

Why does relationship discovery require an approval step before writing?

Relationship discovery requires an approval step to ensure validation, allowing you to review a relationship plan with quoted evidence before any YAML frontmatter or Markdown updates are written to your vault.