Agent skill · software engineering · sundial-org
obsidian
Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
Why this skill is useful
Adds specific commands and workflows for automating Obsidian vault management that the AI wouldn't reliably generate on its own.
What it needs
Requires obsidian-cli installed locally. About 1k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Obsidian Obsidian vault = a normal folder on disk. Vault structure (typical) Notes: .md (plain text Markdown; edit with any editor) Config: .obsidian/ (workspace + plugin settings; usually don’t touch from scripts) Canvases: .canvas (JSON) Attachments: whatever folder you chose in Obsidian settings (images/PDFs/etc.) Find the active vault(s) Obsidian desktop tracks vaults here (source of truth): ~/Library/Application Support/obsidian/obsidian.json obsidian-cli resolves vaults from that file; vault name is typically the folder name (path suffix). Fast “what vault is active / where are the notes?” If you’ve already set a default: obsidian-cli print-default --path-only Otherwise, read ~/Library/Application Support/obsidian/obsidian.json and use the vault entry with "open": true. Notes Multiple vaults common (iCloud vs ~/Documents, work/personal, etc.). Don’t guess; read config. Avoid writing hardcoded vault paths into scripts; prefer reading the config or using print-default. obsidian-cli quick start Pick a default vault (once): obsidian-cli set-default "<vault-folder-name>" obsidian-cli print-default / obsidian-cli print-default --path-only Search obsidian-cli search "query" (note names) obsidian-cli search-content "query" (inside notes; shows snippets + lines) Create obsidian-cli create "Folder/New note" --content "..." --open Requires Obsidian URI handler (obsidian://…) working (Obsidian installed). Avoid creating notes under “hidden” dot-folders (e.g. .something/...) via URI; Obsidian may refuse. Move/rename (safe refactor) obsidian-cli move "old/path/note" "new/path/note" Updates [[wikilinks]] and common Markdown links across the vault (this is the main win vs mv). Delete obsidian-cli delete "path/note" Prefer direct edits when appropriate: open the .md file and change it; Obsidian will pick it up.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/obsidian