obsidian

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

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill obsidian-avatar-arts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/skills/note-taking/obsidian
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill obsidian-avatar-arts

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 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 resolved absolute vault paths. - Content Search: Search note contents with regex patterns restricted to markdown files, avoiding grep or find. - 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 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 note contents in an Obsidian vault?

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. This is preferred over grep or find because it works with resolved absolute paths.

How do I create a new note in Obsidian from an AI assistant?

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

Why can't I pass $OBSIDIAN_VAULT_PATH directly to file tools?

File tools do not expand shell environment variables, so paths containing $OBSIDIAN_VAULT_PATH will fail. Resolve the variable first, using terminal if needed, then pass the concrete absolute path to read_file, write_file, patch, or search_files.

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 appends with no stable anchor, terminal is acceptable as the clearest safe option.

What is the default Obsidian vault path if the environment variable is unset?

If OBSIDIAN_VAULT_PATH is unset, the fallback path is ~/Documents/Obsidian Vault. Vault paths may contain spaces, which is another reason to prefer file tools over shell commands.