obsidian

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

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/musical-basics/hermes-build-2 --skill obsidian-musical-basics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/musical-basics/hermes-build-2/tree/main/skills/note-taking/obsidian
Command: npx skills add https://github.com/musical-basics/hermes-build-2 --skill obsidian-musical-basics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables quick command-line interaction with an Obsidian vault to read, search, and modify markdown notes without leaving the AI workflow.

Core Features & Use Cases

  • Read & List: Retrieve a specific note or enumerate all notes, optionally filtered by folder.
  • Search: Locate notes by filename or content keywords using efficient filesystem commands.
  • Create & Append: Generate new notes or add content to existing ones directly in the vault.
  • Wikilinks Support: Use Obsidian’s [[Note Name]] syntax to link related notes.

Quick Start

Ask the assistant to display the contents of a note named “Meeting Summary” from your Obsidian vault.

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 from the command line?

To search and read markdown notes in an Obsidian vault, you can use shell commands to locate files by filename or content keywords and retrieve their contents directly without leaving your AI workflow.

What's the best way to create or append text to local markdown files in a vault?

The best way to create or append text to local markdown files in a vault is by running shell commands that generate new notes or add content to existing ones, supporting Obsidian's [[Note Name]] wikilink syntax.

Do I need to set an environment variable to manage notes in my local vault?

Yes, managing notes in your local vault requires setting the OBSIDIAN_VAULT_PATH environment variable to point to your files, though it defaults to your Documents directory if not explicitly configured.

Can I list all notes in an Obsidian vault filtered by a specific folder?

Yes, you can list all notes in an Obsidian vault filtered by a specific folder using filesystem commands that enumerate markdown files, allowing you to retrieve a specific note or narrow down your search scope.

Why use command-line interaction to modify markdown notes instead of the Obsidian app?

Using command-line interaction to modify markdown notes enables quick reading, searching, and appending of content directly to local vault files, streamlining your workflow without needing to manually open the Obsidian application.