obsidian

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

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/adm-humanerd/drewgent --skill obsidian-adm-humanerd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/adm-humanerd/drewgent/tree/main/skills/note-taking/obsidian
Command: npx skills add https://github.com/adm-humanerd/drewgent --skill obsidian-adm-humanerd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Obsidian vaults are a centralized place for notes, but reading, finding, and creating notes can be slow when done manually across many files. This skill provides a streamlined, AI-assisted way to read, search, and add notes directly within the vault.

Core Features & Use Cases

  • Read notes from the Obsidian vault to quickly retrieve content.
  • Search notes by filename or content to locate relevant information.
  • Create new notes and link them using Obsidian Wikilinks to build a connected knowledge base.
  • Use cases include quickly locating a concept, adding a new idea, or organizing notes within a vault.

Quick Start

Ask the agent to read a note, search the vault, or create a new note at a chosen path.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I search for a specific note in an Obsidian vault?

To search an Obsidian vault, the skill scans Markdown files by filename or content to locate matching notes. This allows quick retrieval of specific concepts or information stored within the local or shared vault.

Can I create new notes and add Wikilinks in Obsidian programmatically?

Yes, you can create new notes and add Obsidian Wikilinks programmatically. The skill creates entries at a chosen path and uses Wikilinks to connect them, helping build a linked knowledge base.

Do I need a specific environment variable to read Markdown files from an Obsidian vault?

Yes, you need the OBSIDIAN_VAULT_PATH environment variable to read Markdown files from an Obsidian vault. This variable must point to the vault location and supports paths that include spaces.

What is the best way to organize and retrieve content from a personal knowledge base?

The best way to organize a personal knowledge base is using an AI-assisted skill to read, search, and create Markdown notes. This streamlines finding concepts and adding ideas without manual file browsing.

Does this approach work for team workspaces with shared Markdown vaults?

Yes, this approach works for team workspaces with shared Markdown vaults. The skill operates on vaults stored locally or on shared drives, allowing team members to search and add notes efficiently.

Why does my vault search fail when the path contains spaces?

A vault search might fail if the OBSIDIAN_VAULT_PATH is not configured correctly. The skill explicitly supports spaces in paths, so ensure the environment variable accurately points to the vault directory.