obsidianlisted

# Obsidian Vault An Obsidian vault is just a folder of markdown (`.md`) files linked with `[[wikilinks]]`. This skill is filesystem-first: reading notes, listing notes, searching note files, creating notes, appending content, and adding wikilinks — all with normal file tools. ## Vault path Resolve a concrete absolute vault path before doing anything. - Convention: the vault path may be in the `OBSIDIAN_VAULT_PATH` environment variable. Resolve it with bash: `echo "$OBSIDIAN_VAULT_PATH"`. - If unset, fall back to `~/Documents/Obsidian Vault` (check it exists: `ls -d ~/Documents/Obsidian\ Vault`). - Vault paths often contain spaces — always quote them in bash, and pass a fully-resolved absolute path (not `$OBSIDIAN_VAULT_PATH`) to the Read/Write/Edit tools, which do not expand shell variables. ## Read a note Use the **Read** tool with the resolved absolute path. It gives line numbers and pagination — better than `cat`. ## List notes Use the **Glob** tool against the vault path. - All markdown notes: pattern `**/*.md` under the vault path. - A subfolder: pattern `**/*.md` rooted at that subfolder's absolute path. ## Search - **Filename search** → Glob with a name pattern (e.g. `**/meeting*.md`). - **Content search** → Grep with the regex as the pattern, `path` set to the vault, and `glob: "*.md"` to restrict matches to notes. ## Create a note Use the **Write** tool with the resolved absolute path and the full markdown content. Avoids shell-quoting issues from heredo