obsidian

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

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/swcstudiospace/aimeecodes --skill obsidian-swcstudiospace
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/swcstudiospace/aimeecodes/tree/main/.aimee/skills/obsidian
Command: npx skills add https://github.com/swcstudiospace/aimeecodes --skill obsidian-swcstudiospace

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an Obsidian vault through an AI agent requires consistent, safe file operations. This Skill provides a filesystem-first workflow for reading, listing, searching, creating, and editing markdown notes without shell quoting errors or path resolution mistakes. ## Core Features & Use Cases - Note Reading and Listing: Read notes with line numbers via read_file and list markdown files with search_files using glob patterns. - Content Search: Search note contents with regex patterns restricted to markdown files using file_glob. - Note Creation and Editing: Create notes with write_file, append content with anchored patch edits, and link related notes using [[wikilink]] syntax. - Use Case: Ask the agent to find every note mentioning a project keyword, then create a summary note that wikilinks to each matching note in your vault. ## Quick Start Search my Obsidian vault for all notes mentioning "roadmap" and create a new index 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 Obsidian notes by content?▼

Use search_files with target set to content, a regex pattern for the text, and file_glob set to *.md to restrict matches to markdown notes. Always pass the resolved absolute vault path rather than a shell variable.

How do I create a new note in an Obsidian vault?▼

Use write_file with the resolved absolute path and the full markdown content of the note. This avoids shell quoting issues from heredocs or echo and returns structured results.

Where is the Obsidian vault path configured?▼

The vault path comes from the OBSIDIAN_VAULT_PATH environment variable, typically defined in ${HERMES_HOME:-~/.hermes}/.env. If unset, the fallback 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. Resolve the vault path first, then pass a concrete absolute path, which also handles vault paths containing spaces.

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 a section after a heading. Use write_file to rewrite the whole note when a patch would be fragile.