obsidian

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing an Obsidian knowledge base requires manual file operations; this Skill lets you read, search, create, and append notes in your vault directly through shell commands without opening the Obsidian app. ## Core Features & Use Cases - Read and List Notes: View note contents or list all Markdown files in the vault or a specific subfolder. - Search by Name or Content: Find notes by filename pattern or full-text keyword search using find and grep. - Create and Append Notes: Write new notes with wikilinks or append content to existing notes. - Use Case: Ask the assistant to save meeting takeaways as a new note in your vault, linked to related project notes via [[wikilinks]], then later search all notes mentioning a specific topic. ## Quick Start Create a new note called Project Ideas in my Obsidian vault with a short outline and link it to my existing Roadmap note.

Frequently Asked Questions about obsidian

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

FAQPage Schema
How do I search notes in an Obsidian vault from the command line?

Use find with -iname to search note filenames, or grep -rli with --include="*.md" to search note contents. Both commands operate directly on the vault directory without needing the Obsidian app running.

How do I create a new Obsidian note programmatically?

Write a Markdown file into the vault directory using cat with a heredoc, for example cat > "$VAULT/New Note.md". Include [[Note Name]] wikilink syntax to link the new note to related content.

Where is the Obsidian vault path configured?

The vault location is set via the OBSIDIAN_VAULT_PATH environment variable, typically in ~/.hermes/.env. If unset, it defaults to ~/Documents/Obsidian Vault.

Why do Obsidian vault commands fail with spaces in the path?

Vault paths often contain spaces, such as the default Obsidian Vault folder name. Always quote the path variable, for example "$VAULT/Note Name.md", so the shell treats it as a single argument.

Can I append content to an existing Obsidian note?

Yes, use echo with the >> append operator to add text to the end of an existing note file. This preserves the current content while adding new lines.