← Back to Skills Marketplace
dial481

Obsidian Vault Linker

by dial481 · GitHub ↗ · v1.0.4 · MIT-0
cross-platform ✓ Security Clean
76
Downloads
1
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install obsidian-vault-linker
Description
Discover and write typed relationships between Obsidian vault notes. Uses plain Markdown and YAML — no plugins required. Works with any AI agent that has fil...
Usage Guidance
This skill appears coherent for linking Obsidian notes, but be careful with file access and autonomy: 1) Only point the skill to the specific vault folder you want processed (avoid root or home directories). 2) Keep the default workflow: allow it to read and report findings first, and only permit writes after you review them. 3) Avoid enabling 'run autonomously' unless you trust the agent and have backups of your vault. 4) If you have concerns, run it in a copy of your vault first to inspect what changes it proposes.
Capability Analysis
Type: OpenClaw Skill Name: obsidian-vault-linker Version: 1.0.4 The obsidian-vault-linker skill is a legitimate tool designed to help users manage relationships between notes in an Obsidian vault using standard Markdown and YAML frontmatter. The instructions in SKILL.md emphasize a 'read-report-write' workflow that prioritizes user approval and data integrity, with no evidence of malicious intent, data exfiltration, or unauthorized execution. It utilizes standard file operations and optionally leverages the official Obsidian CLI for discovery.
Capability Assessment
Purpose & Capability
The name/description (discover and write relationships between Obsidian notes) matches the SKILL.md: it reads Markdown files/frontmatter/wikilinks and can write Markdown/YAML links. It does not request unrelated credentials or tools.
Instruction Scope
Instructions correctly focus on vault files, frontmatter, tags, filenames and wikilinks and recommend using the Obsidian CLI if available. However, the instructions assume the agent has file-system access and include open-ended modes like 'look at this folder' and an optional autonomous mode that allows writing without per-link approval if the user explicitly grants it — this can be broad if the user points the skill at a non-vault or system folder.
Install Mechanism
No install spec or code is present (instruction-only), so nothing is downloaded or written by an installer. The only executable interactions suggested are optional use of an existing Obsidian CLI if present.
Credentials
The skill requires no environment variables, credentials, or config paths. File access to the vault is necessary for the stated purpose and is the only resource referenced.
Persistence & Privilege
always is false and the skill is user-invocable; model invocation is allowed (the platform default). Because the skill can write files (with user approval by default, or autonomously if explicitly permitted), granting it autonomous privileges or pointing it at broad filesystem locations increases risk.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install obsidian-vault-linker
  3. After installation, invoke the skill by name or use /obsidian-vault-linker
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
No user-facing changes in this version. - No file changes detected from previous release. - Functionality and documentation remain the same.
v1.0.2
Initial release of obsidian-vault-linker - Enables discovery and creation of typed relationships between Obsidian notes using plain Markdown and YAML—no plugins required. - Supports both manual (user-approved) and autonomous (batch) linking workflows, with summaries of changes. - Recognizes 24 standard relationship types (e.g., supports, contradicts, parent_of, caused_by) and allows for custom types determined before each run. - Utilizes Obsidian CLI for enhanced vault analysis if available, or falls back to direct file reading. - Prioritizes meaningful, high-value connections (contradictions, causal chains, cross-domain links) while minimizing low-value or tenuous links. - Adapts to different vault structures (hub-and-spoke or flat) and guides user toward high-quality knowledge links.
v1.0.0
Initial release of obsidian-vault-linker — a tool for discovering and curating typed relationships between Obsidian notes using only Markdown and YAML. - Analyze Obsidian vaults to find meaningful connections between notes, guided by user prompts. - Supports 24 standard relationship types (e.g., supersedes, supports, contradicts, parent_of, causes, implements) as used in the Penfield memory system. - Works with plain Markdown/YAML—no plugins, databases, or external tools required. - Prefers using the Obsidian CLI for enhanced discovery if available, with a fallback to direct file reading. - Emphasizes a human-in-the-loop workflow: read, report findings, and only write changes after user approval. - Designed for targeted, focused, and exploratory analysis, prioritizing high-value discoveries like contradictions, cross-domain links, and superseded knowledge.
v1.0.1
- Added expanded documentation outlining how to discover and record typed relationships between Obsidian notes using plain Markdown and YAML. - Detailed analysis process: understand the request, read and summarize notes, identify candidate relationships, and present findings for approval before writing. - Listed 24 standard relationship types (e.g., supports, contradicts, parent_of, example_of) along with definitions and guidance for selection. - Included guidelines for prioritizing high-value knowledge discoveries and filtering out low-value or speculative relationships. - Clarified use of Obsidian CLI for vault exploration, with fallback to direct file reading if unavailable.
Metadata
Slug obsidian-vault-linker
Version 1.0.4
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is Obsidian Vault Linker?

Discover and write typed relationships between Obsidian vault notes. Uses plain Markdown and YAML — no plugins required. Works with any AI agent that has fil... It is an AI Agent Skill for Claude Code / OpenClaw, with 76 downloads so far.

How do I install Obsidian Vault Linker?

Run "/install obsidian-vault-linker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Obsidian Vault Linker free?

Yes, Obsidian Vault Linker is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Obsidian Vault Linker support?

Obsidian Vault Linker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Obsidian Vault Linker?

It is built and maintained by dial481 (@dial481); the current version is v1.0.4.

💬 Comments