obsidian

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

2|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/AlexiosBluffMara/mercury --skill obsidian-alexiosbluffmara
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/AlexiosBluffMara/mercury/tree/main/skills/note-taking/obsidian
Command: npx skills add https://github.com/AlexiosBluffMara/mercury --skill obsidian-alexiosbluffmara

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Obsidian vaults are powerful for personal knowledge management, but quickly accessing, organizing, and referencing notes across folders can be tedious. This skill provides simple, repeatable commands to read, list, search, create, and link Markdown notes inside an Obsidian vault from any environment.

Core Features & Use Cases

  • Read a note by file name to retrieve its content.
  • List all Markdown notes within the vault or a subfolder.
  • Search by filename or content to locate relevant notes and build knowledge graphs with Wikilinks.
  • Create new notes and append content to existing ones to capture ideas on the fly.
  • Wikilinks guidance: use Obsidian-style [[Note Name]] to link related content and improve navigation.

Quick Start

Read a note from the Obsidian vault by setting OBSIDIAN_VAULT_PATH and opening a Markdown file.

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 inside an Obsidian vault?

You can read and search Markdown notes inside an Obsidian vault by using commands that locate files based on filename or content. This requires setting the OBSIDIAN_VAULT_PATH environment variable to expose your vault contents.

Can I create new notes and append content to existing Markdown files?

Yes, you can create new Markdown notes and append content to existing ones. This enables quick knowledge capture directly from your environment, allowing you to capture ideas on the fly without manually opening the vault.

Do I need to set an environment variable to access my Obsidian vault?

Yes, accessing your Obsidian vault requires setting the OBSIDIAN_VAULT_PATH environment variable. This variable is used to locate the vault directory so the skill can operate on your Markdown files.

What is the best way to link related Obsidian notes during research workflows?

The best way to link related notes is by using Obsidian-style Wikilinks, specifically the [[Note Name]] syntax. This improves navigation and helps build knowledge graphs across your vault folders during research workflows.

How do I list all Markdown notes within a specific vault subfolder?

You can list all Markdown notes within a specific subfolder using the vault listing command. This allows you to enumerate files within the entire Obsidian vault or target a specific directory to locate relevant notes.

Does this approach work for personal knowledge management and research workflows?

Yes, this approach works for personal knowledge management and research workflows. It provides repeatable commands to read, search, create, and link Markdown notes, streamlining knowledge capture and note linking across vault folders.