obsidian

Read, search, and update Markdown notes in an Obsidian vault.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MarbleSodas/Mavis --skill obsidian-marblesodas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/MarbleSodas/Mavis/tree/main/skills/note-taking/obsidian
Command: npx skills add https://github.com/MarbleSodas/Mavis --skill obsidian-marblesodas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the hassle of manually opening Obsidian to read, search, and update markdown notes, especially when you need to do it repeatedly or at scale.

Core Features & Use Cases

  • Read notes by absolute path: Load specific markdown notes reliably using file-tool reads rather than shell commands.
  • List and search notes: Find notes by filename and content, including content-regex searches limited to markdown files.
  • Create and edit notes: Write new notes, append content, and make targeted edits using stable anchors, plus create Obsidian wikilinks for connected knowledge.

Quick Start

Use the obsidian skill to append a new section to an existing note in your vault by first resolving the vault path and then patching the note at the correct heading.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I search and read markdown notes in an Obsidian vault programmatically?

Search and read markdown notes in an Obsidian vault by resolving the vault path to an absolute directory, then using deterministic file operations to find files by filename or content-regex and load specific notes.

What is the best way to automate Obsidian vault updates without opening the app?

Automate Obsidian vault updates by using file-tool write and patch operations to append content and make targeted edits at stable anchors, eliminating the need to manually open the Obsidian application.

Can I create wikilinks between markdown notes using filesystem operations?

Yes, you can create wikilinks between markdown notes by resolving the vault path and using deterministic write_file or patch operations to insert the wikilink syntax directly into the target markdown content.

Does this approach restrict content searches to markdown files only?

Yes, content searches are restricted to markdown globs when appropriate, ensuring that regex and filename lookups within the resolved Obsidian vault directory only return relevant markdown note files.

How do I append a new section to an existing markdown note in my vault?

Append a new section to an existing markdown note by resolving the absolute vault directory path and applying a targeted patch operation at the correct heading or stable anchor within the file.

Why do I need to resolve the vault path before reading or editing notes?

Resolving the vault path to a concrete absolute directory is required because the underlying read_file, write_file, patch, and search_files operations depend on absolute paths to locate and modify the markdown notes safely.