obsidian

Automate Obsidian vault note operations and wikilink updates via obsidian-cli.

2|2|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/pynbj1001/agent-workspace --skill obsidian-pynbj1001
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/pynbj1001/agent-workspace/tree/main/skills/obsidian
Command: npx skills add https://github.com/pynbj1001/agent-workspace --skill obsidian-pynbj1001

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many users keep knowledge as plain Markdown in Obsidian vaults but lack reliable, scriptable ways to find the active vault, search and edit notes, or perform safe refactors that preserve internal links. This Skill documents how to locate vaults from Obsidian's configuration and use obsidian-cli to automate common note operations.

Core Features & Use Cases

  • Resolve active vaults and paths: Read Obsidian's configuration to discover available vaults and detect which is open.
  • Search and extract content: Perform filename and content searches across vault notes to locate relevant information and snippets.
  • Create, move, rename, and delete notes: Use obsidian-cli to programmatically create notes, move or rename files while updating wikilinks, and delete notes safely.
  • Use Case: Automate daily note creation in the default vault, bulk-update links after a folder refactor, or compile search results into a summary document.

Quick Start

Set the default vault to MyVault and create a new note titled Meeting Notes containing today's summary using obsidian-cli.

Frequently Asked Questions about obsidian

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate creating and searching notes in an Obsidian vault?

Automate Obsidian vault operations by using the obsidian-cli binary to resolve active vault paths from the configuration file and programmatically create, search, or edit Markdown notes for scriptable management of routine note operations.

How do I safely rename or move Markdown files without breaking internal wikilinks?

To safely refactor Markdown notes without breaking wikilinks, use obsidian-cli to move or rename files within the local Obsidian vault. This updates internal wikilinks automatically during the file operation to preserve link integrity across the vault.

How does an automation script find the active Obsidian vault path?

Finding the active Obsidian vault path is done by reading Obsidian's internal configuration file. The automation script resolves available vaults and detects which local vault folder is currently open to target the correct directory for note operations.

Do I need obsidian-cli installed to automate vault management tasks?

Yes, obsidian-cli is required to automate vault management tasks. The binary provides the command-line interface necessary to interact with local Obsidian vault folders, resolve paths, and execute routine note operations like searching and creating content.

What is the best way to bulk-update internal links after a folder refactor?

The best way to bulk-update links after a folder refactor is using obsidian-cli to move or rename notes within the vault. This approach automatically updates internal wikilinks to reflect the new file paths, ensuring no links are broken during the restructure.

Can I search across multiple Obsidian vaults to extract content snippets?

You can perform filename and content searches across local Obsidian vaults to locate relevant information and snippets. By reading the configuration to discover available vaults, the search targets the active vault directories to extract matching Markdown content.