obsidian

Search, read, and edit Markdown notes in Obsidian vaults via filesystem access.

Updated Jul 6, 2026
One-click install
npx skills add https://github.com/ghufronbagaskara/agent-im --skill obsidian-ghufronbagaskara
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/ghufronbagaskara/agent-im/tree/main/hermes-home/skills/note-taking/obsidian
Command: npx skills add https://github.com/ghufronbagaskara/agent-im --skill obsidian-ghufronbagaskara

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill bridges the gap between your AI agent and your local Obsidian vault, allowing for direct file manipulation without needing to manually open the application or navigate complex directory structures.

Core Features & Use Cases

  • Vault Integration: Provides a standardized way to locate and interact with notes based on environment variables or fallback paths.
  • Content Management: Supports searching, reading, creating, and appending to markdown notes using native file tools.
  • Use Case: Quickly search for a specific project note, append a new meeting summary to it, or create a new daily log entry while maintaining your existing wikilink structure.

Quick Start

Use the obsidian skill to search for all notes containing the term project-alpha and display the content of the most relevant file.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I manage markdown notes in my Obsidian vault using an AI agent?

This skill facilitates direct filesystem interaction with your Obsidian markdown vault, allowing an AI agent to read, search, create, and edit notes. It operates by resolving vault paths and utilizing atomic file operations across Linux, macOS, and Windows environments.

Can I append content to existing markdown notes without breaking wikilinks?

You can append content to existing markdown notes while maintaining your wikilink structure. The skill performs atomic file operations directly on the markdown files within your designated vault directory without requiring the Obsidian application to be open.

Does this Obsidian vault integration work across different operating systems?

The Obsidian vault integration works across Linux, macOS, and Windows environments. It resolves your specific vault paths using environment variables or fallback paths to ensure consistent file operations on any operating system.

What do I need to set up before searching and reading markdown files in my vault?

You need standard file-system access permissions and a designated Obsidian vault directory. The skill locates your vault based on environment variables or fallback paths to begin searching and reading markdown files.

What's the best way to search for a specific term across my local knowledge base?

The best way to search for a specific term in your local knowledge base is using this skill's native file tools. It searches through your markdown vault directory and displays the content of the most relevant files directly to your AI agent.