obsidian

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

1|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/maopujie10-sys/Bailongma --skill obsidian-maopujie10-sys
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/maopujie10-sys/Bailongma/tree/main/skills/hermes-skills/note-taking/obsidian
Command: npx skills add https://github.com/maopujie10-sys/Bailongma --skill obsidian-maopujie10-sys

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, searching, creating, and editing markdown notes without fragile shell commands or quoting errors. ## Core Features & Use Cases - Note Reading and Listing: Read notes with line numbers via read_file and list markdown files across the vault or subfolders using search_files. - Filename and Content Search: Search note filenames with patterns or search note contents with regex restricted to markdown files. - 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 Use the obsidian skill to search my vault for notes mentioning project alpha and create a summary note linking to 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 you want, 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 problems that occur with heredocs or echo, and you can include [[wikilinks]] to connect related notes.

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. If no stable anchor exists, rewriting the whole note with write_file or a terminal append is acceptable.

Why do file tools fail with $OBSIDIAN_VAULT_PATH in the path?

File tools do not expand shell environment variables, so paths containing $OBSIDIAN_VAULT_PATH fail. Resolve the variable first using the terminal or use the fallback path ~/Documents/Obsidian Vault, then pass the concrete absolute path.

Can I use shell commands like grep or find on the vault?

The skill prefers search_files over grep, find, or ls because it returns structured results and handles paths with spaces safely. Terminal commands are acceptable only for resolving the vault path or simple appends without stable context.