obsidian-fns

Use this skill to operate a remote Obsidian vault through Fast Note Sync.

Use the action layer by default

Prefer these high-level commands for normal work:

python3 {baseDir}/scripts/fns_actions.py search-notes --keyword "OpenClaw"
python3 {baseDir}/scripts/fns_actions.py read-note --path "OpenClaw/API-Test.md"
python3 {baseDir}/scripts/fns_actions.py write-note --path "OpenClaw/API-Test.md" --content "# hello"
python3 {baseDir}/scripts/fns_actions.py append-note --path "OpenClaw/API-Test.md" --content "\n- one more line"

Use the lower-level CLI only when you need debugging, unsupported operations, or direct API diagnosis:

python3 {baseDir}/scripts/fns.py --help

Operating rules

• Prefer search-notes, read-note, write-note, and append-note for routine tasks.
• Read first if the target note/path is uncertain.
• Avoid overwriting an existing note blindly when append is enough.
• For exploratory or risky work, create or use a dedicated test path first.
• Keep existing compatibility assumptions intact unless the user explicitly asks to migrate config keys or paths.

Supported capabilities

This skill has verified support for:

• login and token reuse
• vault listing and tree inspection
• note search and read
• write, append, prepend, replace
• rename and move
• history lookup
• Chinese paths and paths with spaces

References

Read these only when needed:

• references/usage.md — commands, configuration sources, validated environment, and packaging notes