obsidian

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

Updated Jun 5, 2026
One-click install
npx skills add https://github.com/xu1713/openhorse --skill obsidian-xu1713
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/xu1713/openhorse/tree/main/openhorse/openhorse/skills/note-taking/obsidian
Command: npx skills add https://github.com/xu1713/openhorse --skill obsidian-xu1713

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an Obsidian vault through an AI assistant requires consistent, safe file operations—resolving vault paths, searching notes, and editing markdown without shell quoting errors or broken wikilinks. ## Core Features & Use Cases - Vault Path Resolution: Uses the OBSIDIAN_VAULT_PATH environment variable with a fallback to ~/Documents/Obsidian Vault, always passing concrete absolute paths to file tools. - Note Operations: Read notes with line numbers, list and search notes by filename or content, create new notes, and append or patch content with anchored edits. - Wikilink Support: Creates [[Note Name]] links when authoring notes to keep the vault's knowledge graph connected. - Use Case: Ask the assistant to find every note mentioning a project keyword, then create a summary note linking to each result with wikilinks. ## 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 to find notes by name, or target "content" with a regex pattern and file_glob "*.md" to search note contents. Always pass the resolved absolute vault path rather than shell variables.

How do I append content to an existing Obsidian note?

Read the note first, then use patch for an anchored append when stable context exists, such as adding a section after a known heading. For a simple append with no anchor, a terminal command is acceptable as the clearest safe option.

How is the Obsidian vault path configured?

The vault path comes from the OBSIDIAN_VAULT_PATH environment variable, typically set in ~/.hermes/.env. If unset, it falls back to ~/Documents/Obsidian Vault. File tools cannot expand shell variables, so the path must be resolved to an absolute path first.

Why do file tools fail with $OBSIDIAN_VAULT_PATH in the path?

File tools like read_file, write_file, patch, and search_files do not expand shell variables, so a literal $OBSIDIAN_VAULT_PATH string causes failures. Resolve the variable to a concrete absolute path before calling any file tool.

Can I create wikilinks between Obsidian notes automatically?

Yes, when creating notes the skill uses Obsidian's [[Note Name]] syntax to link related content. This keeps new notes connected to the existing vault knowledge graph without manual link editing.