obsidian

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

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill obsidian-chenhui-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/CHENHUI-X/toolbox/tree/main/official-skills/note-taking/obsidian
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill obsidian-chenhui-x

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 Path Resolution: Resolves the vault location from the OBSIDIAN_VAULT_PATH environment variable or falls back to ~/Documents/Obsidian Vault before any file operation. - Note Operations: Read notes with line numbers, list markdown files, search filenames and note contents, create new notes, and append or patch content with anchored edits. - Wikilink Support: Creates [[Note Name]] wikilinks when authoring notes to keep the vault's knowledge graph connected. - Use Case: Ask the agent to find every note mentioning a project, then create a summary note that wikilinks to each of them. ## Quick Start Search my Obsidian vault for all notes mentioning "quarterly planning" and create a new summary note linking to each one.

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" 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 with read_file, then use patch for an anchored append when stable context exists, such as adding after a known heading. For a simple append with no anchor, the terminal tool 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_HOME:-~/.hermes}/.env. If unset, the skill falls back to ~/Documents/Obsidian Vault, and paths must be resolved to absolute form before use.

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. You must resolve the environment variable first, then pass a concrete absolute path, which also handles vault paths containing spaces.

Can I create wikilinks between Obsidian notes?

Yes. When creating notes with write_file, include [[Note Name]] syntax to link related content. Obsidian renders these as internal links, keeping the vault's note graph connected.