Agent skill · software engineering · bitbonsai
obsidian
Activate when the user mentions their Obsidian vault, notes, tags, frontmatter, daily notes, backup, or sync. Route operations across MCP, Obsidian CLI/app actions, and git sync with safe defaults.
Why this skill is useful
Adds specific commands and workflows for managing Obsidian notes and git synchronization that the AI wouldn't reliably generate on its own.
What it needs
Requires obsidian installed locally. About 7k tokens when loaded. Last updated 2026-08-06. 1,593 stars on the source repository.
What this skill does
Obsidian Skill Routing Policy Use the backend that best matches user intent: 1. MCP (default for vault data operations) Read/write/patch/search notes Move/rename notes with movenote, then explicitly repair backlinks Frontmatter and tag updates Metadata and batch note operations 2. Obsidian CLI/App context (only when app context is needed) Open a note in Obsidian from URI Trigger app/plugin workflows that MCP cannot perform 3. CLI git (sync/backup workflows) Initialize repo, configure remote, commit, pull, push Periodic or manual vault backup/sync requests When a request is ambiguous, pick MCP first unless the user explicitly asks for sync/backup/git/app behavior. Safe Note Rename Workflow Use MCP movenote for every note move or rename, even when Obsidian is running. Do not invoke the Obsidian CLI move command automatically: delayed link rewrites can apply stale byte offsets to notes edited after the move began, silently corrupting unrelated content (#176). Reconsider CLI moves only after an upstream fix has been independently retested. Backlink preservation is an explicit, verifiable second step: 1. Before moving, search for the old wikilink target using both its vault-relative path and filename without the extension. If Obsidian is running, its read-only backlinks command may supplement discovery, but it does not replace the MCP search. 2. Move the note with MCP movenote. 3. Read each referring note and patch only exact wikilink targets, including embeds and links with aliases or fragments. Preserve display text ( alias) and #heading / #^block-id suffixes while changing the target. 4. Search again for the old path and basename. Report any remaining references instead of claiming success. 5. searchnotes returns at most 20 results. If a search reaches that cap, or the old basename is ambiguous, tell the user exhaustive backlink repair cannot be proven and ask before continuing with a broader scan. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills bitbonsai/obsidian