obsidian-bases

1# Obsidian Bases
2 
3Use this as a compact workflow and fallback syntax reference. Prefer a
4separately installed `kepano/obsidian-skills` `obsidian-bases` skill, then the
5current [official Bases syntax](https://help.obsidian.md/bases/syntax), for
6detailed or version-sensitive fields and functions.
7 
8Answer design and syntax questions read-only. For a requested `.base` edit,
9resolve the user vault and use one inspected transaction; never write the file
10directly.
11 
12Resolve the installed product root from this skill's own location, not from the
13vault or current working directory:
14 
15```bash
16PRODUCT_ROOT=/absolute/path/to/installed/claude-obsidian
17CORE="$PRODUCT_ROOT/scripts/claude-obsidian.py"
18test -f "$CORE"
19```
20 
21Every `../wiki/references/` link in this file resolves the same way, relative
22to this skill's own directory under `$PRODUCT_ROOT`, never relative to the
23selected vault's `wiki/` directory.
24 
25## Workflow
26 
271. Inspect representative note properties and any existing `.base` file.
282. Define the smallest filter that selects the intended notes.
293. Add formulas only for values that must be computed.
304. Choose views and display order. Do not assume a view type or option is
31   supported by the user's Obsidian version or installed plugins.
325. Validate YAML, expression quoting, property names, formula references, and
33   null handling.
346. Preview the complete file and expected result set before a mutation.
357. If an edit was requested, read
36…