How do I install the Obsidian Skill skill?

Run npx skillmds@latest add wizzy15/obsidian-skill in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Obsidian Skill safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Obsidian Skill?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Obsidian Skill free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Obsidian Skill?

wizzy15 (@wizzy15) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Obsidian Skill by wizzy15 — Agent Skill

Name: Obsidian Skill
Author: wizzy15

Obsidian Skill

Controls Obsidian vaults via the official CLI (1.12+). Reads, creates, appends to, and searches notes. Manages daily notes, tasks, tags, properties, templates, bookmarks, and plugins. Analyzes knowledge graph structure including backlinks, orphans, and unresolved links. Triggers on Obsidian, vault, notes, daily notes, knowledge base, PKM, second brain, zettelkasten, backlinks, or note-taking tasks.

wizzy15 aca8409 4 files · 10.8 KB Updated Sep 17, 2026

File contents

Obsidian CLI

Controls the running Obsidian app via IPC. First invocation launches Obsidian if not running.

Prerequisites

Install Obsidian 1.12+
Enable CLI: Settings → General → Command line interface → follow registration prompt
Restart terminal (registration adds obsidian to PATH automatically)

Platform-specific PATH details:

macOS: appends /Applications/Obsidian.app/Contents/MacOS to ~/.zprofile
Linux: symlink at /usr/local/bin/obsidian (fallback ~/.local/bin/obsidian)
Windows: requires Obsidian.com redirector from Discord #insider-desktop-release

Syntax

obsidian <command> [vault=<name>] [file=<name>] [path=<path>] [flags] [--copy]

Pattern	Behavior
`vault=<name>`	Target vault by name; defaults to cwd vault or active vault
`file=<name>`	Wikilink-style resolution (no path/extension needed)
`path=<path>`	Exact vault-relative path, e.g. `path="Folder/Note.md"`
`total`	Return count instead of list
`format=json\|text\|csv\|tsv\|md`	Output format (varies per command)
`--copy`	Copy any command's output to clipboard
`\n` / `\t`	Newline / tab in content strings
No file/path	Defaults to active file in Obsidian
Bare `obsidian`	Opens interactive TUI with autocomplete + `Ctrl+R` history

Quick start

These five operations cover most agent tasks. For complete command reference, see the domain-specific guides below.

Read a note

obsidian read file="Meeting Notes"
obsidian read path="Projects/Roadmap.md"
obsidian read                              # active file

Create a note

obsidian create name="New Note" content="# Title\n\nBody"
obsidian create name="From Template" template="Meeting Notes" silent

Append / prepend

obsidian append file="Journal" content="- New entry"
obsidian prepend file="Ideas" content="## Latest idea"
obsidian daily:append content="- 2pm: Call with team" silent

Search

obsidian search query="project deadline"
obsidian search query="API" limit=10 format=json
obsidian search query="fix" matches         # include context

Tasks

obsidian tasks all todo                     # vault-wide incomplete
obsidian tasks daily                        # today's daily note
obsidian task file="Todo" line=8 toggle     # toggle completion

Reference guides

Load these on demand based on the task:

Task	Reference
Read, create, edit, move, delete notes; outline; word count; unique notes	references/note-operations.md
Search, tags, properties, backlinks, orphans, unresolved links, aliases	references/search-metadata.md
Daily notes, tasks, templates	references/daily-tasks-templates.md
Vault info, files/folders, bookmarks, plugins, workspaces, themes, sync, publish, bases, dev tools	references/vault-management.md

---name: obsidian-skilldescription: Controls Obsidian vaults via the official CLI (1.12+). Reads, creates, appends to, and searches notes. Manages daily notes, tasks, tags, properties, templates, bookmarks, and plugins. Analyzes knowledge graph structure including backlinks, orphans, and unresolved links. Triggers on Obsidian, vault, notes, daily notes, knowledge base, PKM, second brain, zettelkasten, backlinks, or note-taking tasks.license: MIT---# Obsidian CLIControls the running Obsidian app via IPC. First invocation launches Obsidian if not running.## Prerequisites1. Install Obsidian 1.12+2. Enable CLI: **Settings → General → Command line interface** → follow registration prompt3. Restart terminal (registration adds `obsidian` to PATH automatically)Platform-specific PATH details:- **macOS**: appends `/Applications/Obsidian.app/Contents/MacOS` to `~/.zprofile`- **Linux**: symlink at `/usr/local/bin/obsidian` (fallback `~/.local/bin/obsidian`)- **Windows**: requires `Obsidian.com` redirector from Discord `#insider-desktop-release`## Syntax```obsidian <command> [vault=<name>] [file=<name>] [path=<path>] [flags] [--copy]```| Pattern | Behavior ||---------|----------|| `vault=<name>` | Target vault by name; defaults to cwd vault or active vault || `file=<name>` | Wikilink-style resolution (no path/extension needed) || `path=<path>` | Exact vault-relative path, e.g. `path="Folder/Note.md"` || `total` | Return count instead of list || `format=json\|text\|csv\|tsv\|md` | Output format (varies per command) || `--copy` | Copy any command's output to clipboard || `\n` / `\t` | Newline / tab in content strings || No file/path | Defaults to active file in Obsidian || Bare `obsidian` | Opens interactive TUI with autocomplete + `Ctrl+R` history |## Quick startThese five operations cover most agent tasks. For complete command reference, see the domain-specific guides below.### Read a note```bashobsidian read file="Meeting Notes"obsidian read path="Projects/Roadmap.md"obsidian read # active file```### Create a note```bashobsidian create name="New Note" content="# Title\n\nBody"obsidian create name="From Template" template="Meeting Notes" silent```### Append / prepend```bashobsidian append file="Journal" content="- New entry"obsidian prepend file="Ideas" content="## Latest idea"obsidian daily:append content="- 2pm: Call with team" silent```### Search```bashobsidian search query="project deadline"obsidian search query="API" limit=10 format=jsonobsidian search query="fix" matches # include context```### Tasks```bashobsidian tasks all todo # vault-wide incompleteobsidian tasks daily # today's daily noteobsidian task file="Todo" line=8 toggle # toggle completion```## Reference guidesLoad these on demand based on the task:| Task | Reference ||------|-----------|| Read, create, edit, move, delete notes; outline; word count; unique notes | [references/note-operations.md](references/note-operations.md) || Search, tags, properties, backlinks, orphans, unresolved links, aliases | [references/search-metadata.md](references/search-metadata.md) || Daily notes, tasks, templates | [references/daily-tasks-templates.md](references/daily-tasks-templates.md) || Vault info, files/folders, bookmarks, plugins, workspaces, themes, sync, publish, bases, dev tools | [references/vault-management.md](references/vault-management.md) |

Frequently asked questions