Skip to main content

Obsidian

Read, search, and create notes in the Obsidian vault.

Skill metadata​

SourceBundled (installed by default)
Pathskills/note-taking/obsidian

Reference: full SKILL.md​

info

The following is the complete skill definition that Hermes loads when this skill is triggered. This is what the agent sees as instructions when the skill is active.

Obsidian Vault

Location: Set via OBSIDIAN_VAULT_PATH environment variable (e.g. in ~/.hermes/.env).

If unset, defaults to ~/Documents/Obsidian Vault.

Note: Vault paths may contain spaces - always quote them.

Read a note​

VAULT="${OBSIDIAN_VAULT_PATH:-$HOME/Documents/Obsidian Vault}"
cat "$VAULT/Note Name.md"

List notes​

VAULT="${OBSIDIAN_VAULT_PATH:-$HOME/Documents/Obsidian Vault}"

# All notes
find "$VAULT" -name "*.md" -type f

# In a specific folder
ls "$VAULT/Subfolder/"
VAULT="${OBSIDIAN_VAULT_PATH:-$HOME/Documents/Obsidian Vault}"

# By filename
find "$VAULT" -name "*.md" -iname "*keyword*"

# By content
grep -rli "keyword" "$VAULT" --include="*.md"

Create a note​

VAULT="${OBSIDIAN_VAULT_PATH:-$HOME/Documents/Obsidian Vault}"
cat > "$VAULT/New Note.md" << 'ENDNOTE'
# Title

Content here.
ENDNOTE

Append to a note​

VAULT="${OBSIDIAN_VAULT_PATH:-$HOME/Documents/Obsidian Vault}"
echo "
New content here." >> "$VAULT/Existing Note.md"

Obsidian links notes with [[Note Name]] syntax. When creating notes, use these to link related content.