obsidian

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an Obsidian vault through an AI agent requires consistent, safe file operations—resolving vault paths, searching notes, and editing markdown without shell quoting errors or broken paths. ## Core Features & Use Cases - Vault Path Resolution: Resolves the vault location via the OBSIDIAN_VAULT_PATH environment variable with a fallback to ~/Documents/Obsidian Vault before any file operation. - Note Operations: Reads notes with line numbers, lists markdown files, searches filenames and note contents, creates notes, and appends or patches content using file tools instead of shell commands. - Wikilink Support: Creates [[Note Name]] wikilinks when authoring notes to connect related content in the vault. - Use Case: Ask the agent to find every note mentioning a project, then create a summary note linking to each one 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 for name searches, or target "content" with a regex pattern and file_glob "*.md" for content searches. Always pass the resolved absolute vault path rather than shell variables.

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

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

How is the Obsidian vault path resolved?▼

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

Why should file tools be used instead of shell commands for Obsidian notes?▼

File tools like read_file, write_file, patch, and search_files avoid shell quoting issues, handle vault paths containing spaces, and return structured results with line numbers. Terminal commands are only acceptable for resolving the vault path itself.

Does this skill support Obsidian wikilinks?▼

Yes. When creating notes, it uses Obsidian's [[Note Name]] wikilink syntax to link related content, preserving the vault's internal linking structure.