obsidian

Obsidian is a routing skill that coordinates operations on an Obsidian vault across three backends with safe defaults: an MCP server for vault data operations, Obsidian CLI/app context for app-specific workflows, and CLI git for sync and backup. It solves the problem of choosing the right backend for a given intent and executing note operations — reads, writes, patches, searches, moves, tag and frontmatter updates — without silently corrupting a vault, defaulting to MCP for data operations unless the user explicitly asks for sync, backup, git, or app behavior.

A central feature is a safe note-rename workflow: it mandates MCP move_note over the Obsidian CLI move (which can apply stale byte offsets and silently corrupt unrelated notes, per an upstream issue), and treats backlink preservation as an explicit, verifiable second step — searching for old wikilink targets by path and basename, patching only exact link targets while preserving aliases and heading/block suffixes, then re-searching to report any remaining references. It documents numerous tool gotchas: patch_note's multi-match and frontmatter-matching behavior and its rejection of empty strings, search_notes's minified JSON and hard 20-result cap, write_note's directory auto-creation and frontmatter merge semantics, and the exact-path confirmation required by delete_note and move_file. Bundled resources cover Obsidian conventions (vault structure, wikilinks, daily notes, frontmatter, tags, templates, URIs), per-tool behavioral patterns, and git sync.

It targets Obsidian users and automation authors who want reliable, non-destructive agent operations on their notes. The skill is safety-first: it emphasizes confirmation-guarded deletes and moves, explicit backlink verification, and honest reporting when exhaustive repair cannot be proven, with no exfiltration or risky system behavior.