Agent skill · software engineering · steipete
obsidian
Work with Obsidian vaults using the official obsidian CLI: read/search/create/edit notes, tasks, links, properties, plugins.
Why this skill is useful
Adds specific commands and workflows for managing Obsidian vaults that the AI wouldn't reliably generate on its own.
What it needs
Requires obsidian installed locally. About 1k tokens when loaded. Last updated 2026-08-07. 385,400 stars on the source repository.
What this skill does
Obsidian Use the official obsidian CLI for Obsidian vault work. Vault files are plain Markdown, so direct file edits are still fine when safer/faster. Requirements Obsidian 1.12.7+ installed. Settings -> General -> Command line interface enabled. obsidian registered on PATH. Obsidian app running; the CLI connects to the running app. Check: macOS registration creates /usr/local/bin/obsidian pointing at the app-bundled CLI. Linux registration copies the binary to ~/.local/bin/obsidian. Vault model Notes: .md. Config: .obsidian/; avoid editing unless asked. Canvases: .canvas JSON. Attachments: vault-configured folder. Multiple vaults are common; pass vault="<name>" when ambiguous. Obsidian desktop tracks vaults here: ~/Library/Application Support/obsidian/obsidian.json Command pattern Parameter values with spaces need quotes. Add --copy to copy output where useful. Common commands Open/read: Search: Create/modify: Move/delete: Daily/tasks: Properties/links: Developer/debug: Notes file=<name> uses Obsidian-style file resolution; path=<vault-relative.md> is exact. Prefer CLI move/delete/property commands for Obsidian-aware updates. Prefer direct Markdown edits for bulk text changes after locating the vault path. Do not rely on third-party obsidian-cli unless user explicitly asks for it.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills steipete/obsidian--b109f3