Obsidian
Use this skill when the user wants to interact with their local Obsidian vault (markdown files).
Vault location
Check OBSIDIAN_VAULT env var or ask the user. Default paths:
- macOS:
~/Documents/Obsidianor~/Library/Mobile Documents/iCloud~md~obsidian/Documents/ - Linux:
~/obsidianor~/Documents/obsidian
Operations
Search notes
bashgrep -r "query" "$OBSIDIAN_VAULT" --include="*.md" -l grep -r "query" "$OBSIDIAN_VAULT" --include="*.md" -n
Read a note
bashcat "$OBSIDIAN_VAULT/path/to/note.md"
List all notes
bashfind "$OBSIDIAN_VAULT" -name "*.md" | sort
Create or append a note
bash# Create new cat > "$OBSIDIAN_VAULT/folder/new-note.md" <<EOF --- created: $(date -I) tags: [tag1, tag2] --- # Title Content here. EOF # Append echo "\n## New Section\n\ncontent" >> "$OBSIDIAN_VAULT/existing-note.md"
Search by frontmatter tag
bashgrep -r "tags:.*mytag" "$OBSIDIAN_VAULT" --include="*.md" -l
Safety notes
- Always resolve
$OBSIDIAN_VAULTbefore operating. - Do not delete notes without explicit user confirmation.
- Preserve existing frontmatter when updating files.


