obsidian

Read, search, create, and append notes in local Obsidian Markdown vaults.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides simple, file-based access to an Obsidian Markdown vault so users can quickly read, search, create, and append notes without opening the Obsidian application.

Core Features & Use Cases

  • Read Notes: Open and display the full contents of a note by filename for review or summarization.
  • List and Browse: Enumerate all Markdown files or list files within a specific vault folder to locate documents.
  • Search by Filename or Content: Find notes matching a keyword in filenames or inside note contents for quick retrieval.
  • Create and Append: Create new notes with standard Markdown and append content to existing notes, supporting Obsidian wikilinks for linking related notes.
  • Use Case: Rapidly gather meeting notes or project references by searching the vault for a topic keyword and compiling matches.

Quick Start

Search the vault for notes containing 'budget' and show matching filenames and content snippets.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I search markdown notes in an Obsidian vault by content or filename?

To search markdown notes in an Obsidian vault, the Skill uses standard shell utilities to find .md files matching keywords in either filenames or content. It returns matching filenames and content snippets from the specified vault path.

Can I create and append text to markdown notes in my Obsidian vault?

Yes, you can create new markdown notes with standard formatting and append content to existing notes. The Skill supports Obsidian wikilinks to connect related notes when creating or appending text to files.

What do I need to read local Obsidian vault files without opening the app?

You need to set the OBSIDIAN_VAULT_PATH environment variable pointing to your local vault directory. The Skill relies on this path and standard shell utilities to read .md files directly without launching the application.

How do I list all markdown files in an Obsidian vault folder?

You can enumerate all markdown files or list files within a specific vault folder by providing the directory path. The Skill scans the vault structure using shell utilities to locate and display .md documents.

What is the best way to gather meeting notes matching a keyword in Obsidian?

The best way to gather meeting notes is to search the vault for a topic keyword. The Skill finds matching content across .md files and compiles filenames with text snippets for rapid reference retrieval.

Does this Obsidian note search approach work with remote or synced vaults?

This approach applies to local markdown-based Obsidian vaults. It operates on .md files using shell utilities, requiring direct file system access via the OBSIDIAN_VAULT_PATH environment variable to function properly.