obsidian

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an Obsidian vault through an AI assistant requires consistent, safe file operations. This Skill provides a filesystem-first workflow for reading, listing, searching, creating, and editing notes without fragile shell commands or quoting issues. ## 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. - Note Operations: Read notes with line numbers, list markdown files, search filenames and note contents, create notes, and append or patch content with anchored edits. - Wikilink Support: Creates [[Note Name]] links between related notes to maintain vault connectivity. - 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 create and link notes in Obsidian?

Use write_file with the resolved absolute path and full markdown content to create a note. Add [[Note Name]] wikilink syntax inside the content to link related notes together within the vault.

How 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, it falls back to ~/Documents/Obsidian Vault. File tools cannot expand shell variables, so resolve the path first.

Why should I avoid shell commands for Obsidian vault edits?

File tools like read_file, write_file, and patch avoid shell quoting issues and return structured results with line numbers. Vault paths may contain spaces, and file tools do not expand variables like $OBSIDIAN_VAULT_PATH, making shell commands error-prone.

How do I 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 adding after a known heading. Use write_file to rewrite the whole note when a patch would be fragile, or terminal for simple appends with no anchor.