skills.rest
jaredcroxton
jaredcroxtonCOMMUNITY
Explore all skills by this author →
GitHub

obsidian

Read, search, and write markdown notes in an Obsidian vault via filesystem operations.

Updated May 16, 2026
Search Tags:#search#obsidian#notes#patch#file operations#wikilinks
One-click install
npx skills add https://github.com/jaredcroxton/hermes-mirror --skill obsidian-jaredcroxton
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: obsidian
Source: https://github.com/jaredcroxton/hermes-mirror/tree/main/agents/skills/note-taking/obsidian
Command: npx skills add https://github.com/jaredcroxton/hermes-mirror --skill obsidian-jaredcroxton

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of manually reading, finding, and updating notes inside an Obsidian vault when you need reliable, repeatable edits across many files.

Core Features & Use Cases

  • Vault-first file operations: read notes, list markdown files, and search by filename or note content within a resolved vault path.
  • Write and update workflows: create new notes and append or patch content using stable anchors to minimize accidental overwrites.
  • Wikilink-friendly note building: generate related-note links using Obsidian [[Note Name]] syntax while creating or editing markdown.
  • Use case: add a new meeting log note, then append a summary to an existing daily notes file, and finally search for “project kickoff” across the vault to confirm everything is linked correctly.

Quick Start

Use the obsidian skill to search for notes containing the phrase "project kickoff" inside 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 for text inside Obsidian markdown notes programmatically?▼

To search for text inside Obsidian markdown notes programmatically, use filesystem-based search_files operations targeting a resolved absolute vault path to find matching filenames or note contents.

What is the best way to append content to an existing Obsidian note without overwriting it?▼

The best way to append content to an existing Obsidian note without overwriting it is to use patch operations with stable anchors, ensuring safe content updates and minimizing accidental data loss.

Can I create new markdown files with wikilinks in my Obsidian vault using file operations?▼

Yes, you can create new markdown files with wikilinks in your Obsidian vault by executing write_file operations that generate related-note links using standard Obsidian [[Note Name]] syntax.

Do I need a specific environment variable to read and write Obsidian notes safely?▼

You need a resolved absolute vault path provided by the OBSIDIAN_VAULT_PATH environment variable or a fallback to safely read and write notes, avoiding unresolved shell variables in file paths.

Why does searching for notes fail when using shell variables in the vault path?▼

Searching for notes fails when using shell variables in the vault path because file-tool operations require a resolved absolute path to correctly locate and read the markdown files.

Related Skills

Explore More Content & Communication Skills→
ZardLi1115ZardLi1115
4

obsidian

Read, search, create, and edit markdown notes in an Obsidian vault.

Community
Intermediate
enclawedenclawed
2

obsidian-vault-maintainer

Maintain Obsidian vault notes with stable wikilinks and frontmatter.

Community
Intermediate
devMoezdevMoez
1

obsidian

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

Community
Intermediate
anxiety135790anxiety135790

obsidian

Read, search, create, and edit markdown notes in an Obsidian vault.

Community
Intermediate