obsidian

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

Updated May 4, 2026
One-click install
npx skills add https://github.com/JamesFincher/gengar --skill obsidian-jamesfincher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/JamesFincher/gengar/tree/main/skills/note-taking/obsidian
Command: npx skills add https://github.com/JamesFincher/gengar --skill obsidian-jamesfincher

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you interact with an Obsidian vault quickly without manually browsing files, so you can read, find, and create notes when you need them.

Core Features & Use Cases

  • Read notes by filename: Load a specific note’s contents for review or quoting.
  • List and organize notes: Find all Markdown notes or narrow to a subfolder.
  • Search by filename or content: Locate notes using case-insensitive name matches or keyword hits inside Markdown.
  • Create and update notes: Generate new note files and append content to existing notes, supporting workflows like meeting notes or ongoing project logs.

Quick Start

Use the obsidian skill to search your Obsidian vault for the keyword "roadmap" in note contents.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I search my Obsidian vault for keywords inside markdown notes?

Search your Obsidian vault by performing case-insensitive full-text keyword matches inside markdown note contents. The skill scans all *.md files in the vault directory specified by OBSIDIAN_VAULT_PATH and returns matching notes for quick retrieval.

Can I create and append content to existing markdown notes in an Obsidian vault?

Create new markdown note files or append content to existing notes in your Obsidian vault. This supports ongoing workflows like meeting notes or project logs by performing deterministic filesystem operations on *.md files.

How do I list all markdown notes in a specific Obsidian vault subfolder?

List all markdown notes or narrow the results to a specific subfolder within your Obsidian vault. The skill locates *.md files using deterministic filesystem operations based on your configured vault root path.

Do I need to set an environment variable to read notes from my Obsidian vault?

You need to set the OBSIDIAN_VAULT_PATH environment variable to define your vault root directory. If not set, the skill defaults to a standard location to perform read, list, search, and create operations on your markdown notes.

What is the best way to retrieve a specific markdown note by filename for review?

Retrieve a specific note by filename using case-insensitive name matching across your Obsidian vault. This loads the exact markdown file contents needed for review, quoting, or lightweight content updates.