obsidian

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

4|Updated May 18, 2026

Search Tags:#note-taking #markdown #search #obsidian #wikilinks #vault management #file editing

Ready to run

npx skills add https://github.com/ZardLi1115/zedclaw --skill obsidian-zardli1115

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/ZardLi1115/zedclaw/tree/main/skills/note-taking/obsidian
Command: npx skills add https://github.com/ZardLi1115/zedclaw --skill obsidian-zardli1115

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It eliminates the friction of manually navigating, searching, and editing an Obsidian vault by letting you perform vault tasks directly and safely from a known path.

Core Features & Use Cases

Read and search notes: Retrieve note contents and locate notes by filename or in-note text without using fragile shell commands.
List notes by patterns: Enumerate markdown notes or scoped subfolders using controlled glob patterns.
Create and update notes: Write new markdown notes, append content with stable context, and apply targeted edits via patches.
Use Obsidian wikilinks: Create links between related notes when generating or updating content.

Quick Start

Use this skill to read and update a specific Obsidian note by resolving the vault path first and then asking to append a new section to the note with the correct wikilinks.

Frequently Asked Questions about obsidian

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I search for text inside markdown notes in an Obsidian vault?▼

You can append content to markdown notes by resolving the vault path first, then applying targeted section patches or appending new sections with stable context to ensure deterministic file updates.

Can I create wikilinks between notes when editing markdown files?▼

Yes, you can generate inter-note wikilinks to build knowledge graphs when creating or updating markdown content, directly connecting related notes within your resolved vault path.

Do I need to set a specific environment variable to manage an Obsidian vault?▼

Yes, vault management requires resolving the absolute vault path via the OBSIDIAN_VAULT_PATH environment variable to ensure safe filesystem tools operate deterministically without shell-variable paths.

What is the best way to list markdown notes in scoped subfolders?▼

The best way to list markdown notes is by enumerating files and scoped subfolders using controlled glob patterns, returning matched markdown files from the resolved absolute vault path.

Why does this approach avoid shell commands for reading and writing notes?▼

This approach avoids shell commands to guarantee deterministic file operations, relying instead on safe filesystem tools like read_file, write_file, and patch to prevent fragile shell-variable path resolution.