Obsidian Skill

Read, search, and write notes in the local Obsidian vault.

Vault location

The vault lives at ~/.obsidian-vault. Do not ask the user where their vault is — always use this path. If the directory does not exist yet, create it before any other operation. An empty vault is a valid state, not an error.

mkdir -p ~/.obsidian-vault/Notes ~/.obsidian-vault/Daily ~/.obsidian-vault/Templates

Search notes

grep -rln --include="*.md" "{query}" ~/.obsidian-vault | head -20
grep -rn  --include="*.md" -C 2 "{query}" ~/.obsidian-vault | head -50

Read a note

cat ~/.obsidian-vault/{path}.md

Find backlinks

grep -rl --include="*.md" "\[\[{note_name}\]\]" ~/.obsidian-vault | head -20

List recent notes

find ~/.obsidian-vault -name "*.md" -type f -mtime -7 | sort | head -20

Add or update a note

mkdir -p ~/.obsidian-vault/Notes
cat > ~/.obsidian-vault/Notes/{title}.md <<'EOF'
---
created: {YYYY-MM-DD}
tags: [{tag1}, {tag2}]
---

{content}
EOF

Guidelines

The vault path is always ~/.obsidian-vault. Never ask the user to configure or supply one.
If the vault directory is missing or empty, create it and tell the user it is ready, then offer to seed a starter structure or add a first note.
Respect the user's notes — never modify or delete an existing note without explicit confirmation.
When presenting search results, show the note title and a short snippet, not the whole file.
Use Obsidian-friendly Markdown: [[wikilinks]], #tags, YAML frontmatter.