From 38af200c7587380034f11421dee0321d773438ed Mon Sep 17 00:00:00 2001
From: SYU8384 <zhuqimo@gmail.com>
Date: Wed, 6 May 2026 03:33:12 +0900
Subject: [PATCH] Prefer installed Folder Notes CLI in skill

---
 .../obsidian-folder-notes-cli/SKILL.md        | 119 +++---------------
 1 file changed, 17 insertions(+), 102 deletions(-)

diff --git a/openclaw-skills/obsidian-folder-notes-cli/SKILL.md b/openclaw-skills/obsidian-folder-notes-cli/SKILL.md
index 0507cbc..b138ada 100644
--- a/openclaw-skills/obsidian-folder-notes-cli/SKILL.md
+++ b/openclaw-skills/obsidian-folder-notes-cli/SKILL.md
@@ -1,123 +1,38 @@
 ---
 name: folder-notes-cli
-description: Use this skill when an OpenClaw agent needs to create, find, list, attach, delete, detach, reattach, rename, or move Obsidian Folder Notes in a vault through the folder-notes CLI. Use it for agent-safe automation against vault folders without opening Obsidian.
+description: Use this skill when an OpenClaw agent needs to create, find, list, attach, delete, detach, reattach, rename, or move Obsidian Folder Notes in a vault through the folder-notes CLI.
 ---
 
 # Folder Notes CLI
 
-Use the repository's `folder-notes` CLI to manage Obsidian Folder Notes from automation. The CLI operates directly on a vault directory and reads plugin settings from:
-
-```text
-<vault>/.obsidian/plugins/folder-notes/data.json
-```
-
-Always pass `--vault <absolute-or-relative-vault-path>`. Commands return JSON by default; parse `ok`, `notePath`, `items`, and `error.message`.
-
-## Setup
-
-From the plugin repository, build the CLI before first use:
+Use the CLI shipped in the installed plugin folder. Always pass `--vault <vault>`.
 
 ```bash
-npm run cli-build
+VAULT=/path/to/vault
+CLI="$VAULT/.obsidian/plugins/folder-notes/folder-notes-cli.cjs"
+node "$CLI" list --vault "$VAULT"
 ```
 
-Set `CLI` to the built file in the plugin repository. Do not assume the skill directory contains the CLI.
+Create or find a folder note:
 
 ```bash
-CLI="<plugin-repo>/dist/folder-notes-cli.cjs"
-node "$CLI" <command> --vault <vault> ...
+node "$CLI" ensure --vault "$VAULT" --folder "Projects/Alpha"
+node "$CLI" get --vault "$VAULT" --folder "Projects/Alpha"
 ```
 
-or through the package binary when installed/linked:
+Attach, detach, move, or rename:
 
 ```bash
-folder-notes <command> --vault <vault> ...
+node "$CLI" attach --vault "$VAULT" --folder "Projects/Alpha" --file "Projects/Alpha/Brief.md"
+node "$CLI" detach --vault "$VAULT" --folder "Projects/Alpha"
+node "$CLI" move-folder --vault "$VAULT" --folder "Projects/Alpha" --to "Archive/Alpha"
+node "$CLI" rename-folder --vault "$VAULT" --folder "Projects/Alpha" --name "Beta"
 ```
 
-## Common Workflows
+If the installed plugin does not include the CLI yet, use `folder-notes` from `PATH` or `node "$PLUGIN_REPO/dist/folder-notes-cli.cjs"` from a checkout.
 
-Create or reuse a folder note and return its path:
-
-```bash
-node "$CLI" ensure --vault /path/to/vault --folder "Projects/Alpha"
-```
-
-Find the folder note for a folder:
-
-```bash
-node "$CLI" get --vault /path/to/vault --folder "Projects/Alpha"
-```
-
-List all folders in the vault that currently have folder notes:
-
-```bash
-node "$CLI" list --vault /path/to/vault
-```
-
-Use an existing file as the folder note:
-
-```bash
-node "$CLI" attach --vault /path/to/vault --folder "Projects/Alpha" --file "Projects/Alpha/Brief.md"
-```
-
-Delete a folder note. By default this moves it into vault-local trash:
-
-```bash
-node "$CLI" delete --vault /path/to/vault --folder "Projects/Alpha"
-```
-
-Only use permanent deletion when explicitly requested:
-
-```bash
-node "$CLI" delete --vault /path/to/vault --folder "Projects/Alpha" --permanent
-```
-
-Detach or reattach a folder note by updating plugin settings:
-
-```bash
-node "$CLI" detach --vault /path/to/vault --folder "Projects/Alpha"
-node "$CLI" reattach --vault /path/to/vault --folder "Projects/Alpha"
-```
-
-Move or rename a folder while preserving folder-note conventions:
-
-```bash
-node "$CLI" move-folder --vault /path/to/vault --folder "Projects/Alpha" --to "Archive/Alpha"
-node "$CLI" rename-folder --vault /path/to/vault --folder "Projects/Alpha" --name "Beta"
-```
-
-## Safety Rules
+## Safety
 
 - Prefer `--dry-run` before destructive or broad operations.
-- Do not use `--force` unless the user explicitly wants to replace an existing folder note.
-- Do not use `--permanent` unless the user explicitly asks for permanent deletion.
-- Treat `ok: false` or any nonzero exit code as a failed operation and report `error.message`.
-- Vault-relative paths must not contain `..`; pass folder and file paths relative to the vault root.
-- The CLI follows plugin settings for `folderNoteName`, `folderNoteType`, `supportedFileTypes`, `storageLocation`, and `templatePath`.
-
-## JSON Shapes
-
-Successful commands include:
-
-```json
-{
-  "ok": true,
-  "command": "ensure",
-  "vault": "/path/to/vault",
-  "folder": "Projects/Alpha",
-  "notePath": "Projects/Alpha/Alpha.md",
-  "actions": []
-}
-```
-
-Failures include:
-
-```json
-{
-  "ok": false,
-  "error": {
-    "code": "unexpected_error",
-    "message": "Folder already has a note: Projects/Alpha/Alpha.md. Use --force to replace it."
-  }
-}
-```
+- Do not use `--force` or `--permanent` unless explicitly requested.
+- Treat `ok: false` or nonzero exit as failure and report `error.message`.