obsidian

Read, search, create, and edit markdown notes in an Obsidian vault.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill obsidian-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/skills/note-taking/obsidian
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill obsidian-vivekgoquest

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an Obsidian vault through an AI agent requires consistent, safe file operations—resolving the vault path, searching notes, and editing markdown without shell quoting errors or broken paths. ## Core Features & Use Cases - Vault Navigation: Resolve the vault path via the OBSIDIAN_VAULT_PATH environment variable with a fallback to ~/Documents/Obsidian Vault. - Note Operations: Read notes with line numbers, list markdown files, search filenames and note contents, create notes, and append or patch content using file tools instead of fragile shell commands. - Wikilink Support: Create notes with [[Note Name]] wikilinks to connect related content in the vault. - Use Case: Ask the agent to find every note mentioning a project keyword, then create a summary note that wikilinks to each matching note. ## Quick Start Search my Obsidian vault for all notes mentioning "quarterly planning" and create a new summary note linking to each of them.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I search notes in an Obsidian vault?▼

Use search_files with target "files" and a filename pattern for name searches, or target "content" with a regex pattern and file_glob "*.md" for content searches. This is preferred over grep, find, or ls.

How do I create or append to an Obsidian note?▼

Create notes with write_file using the resolved absolute path and full markdown content. For appends, read the note first, then use patch with a stable anchor or rewrite the whole note with write_file.

How is the Obsidian vault path configured?▼

Set the OBSIDIAN_VAULT_PATH environment variable, typically in ${HERMES_HOME:-~/.hermes}/.env. If unset, the fallback path is ~/Documents/Obsidian Vault. Always resolve it to an absolute path before calling file tools.

Why can't I pass $OBSIDIAN_VAULT_PATH directly to file tools?▼

File tools like read_file, write_file, patch, and search_files do not expand shell variables. You must resolve the variable to a concrete absolute path first, using terminal only for path resolution if needed.

Does this skill support Obsidian wikilinks?▼

Yes. When creating notes, use Obsidian's [[Note Name]] syntax to link related content. The skill instructs the agent to include wikilinks so new notes connect to existing vault content.