Obsidian skill

📝 Manage and organize Obsidian vaults with CLI tools for notes, tasks, tags, templates, and knowledge graph analysis.

Install

npx -y skills add wizzy15/obsidian-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

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.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.6 KB, as published. Nobody here has run it

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