obsidian

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

1|Updated Aug 6, 2026
One-click install
npx skills add https://github.com/agtktID/indagis-agent --skill obsidian-agtktid
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/agtktID/indagis-agent/tree/main/skills/note-taking/obsidian
Command: npx skills add https://github.com/agtktID/indagis-agent --skill obsidian-agtktid

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an Obsidian vault through an AI assistant requires consistent, safe file operations—resolving the vault path, searching notes, and editing markdown without shell quoting errors or broken paths. This Skill defines a filesystem-first workflow for all common vault operations. ## Core Features & Use Cases - Note Reading & Listing: Read notes with line numbers via read_file and list markdown files with search_files instead of shell commands like find or ls. - Content Search: Search filenames or note contents with regex patterns, optionally restricted to *.md files. - Note Creation & Editing: Create notes with write_file, append content with anchored patch edits, and link related notes using [[wikilink]] syntax. - Use Case: Ask the assistant to create a meeting summary note in your vault, link it to an existing project note, and append action items under a specific heading—all resolved against the OBSIDIAN_VAULT_PATH environment variable. ## Quick Start Create a new note called 'Project Ideas' in my Obsidian vault and link it to my existing 'Roadmap' note.

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 set to "content" and a regex pattern, adding file_glob "*.md" to restrict matches to markdown notes. For filename searches, use target "files" with a filename pattern under the resolved vault path.

How to append content to an existing Obsidian note?▼

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

Where is the Obsidian vault path configured?▼

The vault path comes from the OBSIDIAN_VAULT_PATH environment variable, typically set in ${HERMES_HOME:-~/.hermes}/.env. If unset, the fallback default is ~/Documents/Obsidian Vault.

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 environment variable to a concrete absolute path first, using terminal only for the resolution step.

Does this skill work on Windows, macOS, and Linux?▼

Yes, the skill declares support for linux, macos, and windows platforms. Vault paths may contain spaces on any platform, which is why file tools are preferred over shell commands.