vilvona 1.0.0

package/skills/notion/SKILL.md

@@ -0,0 +1,150 @@
+---
+name: notion
+description: "Notion CLI/API for pages, Markdown content, data sources, files, comments, search, Workers, and raw API calls."
+homepage: https://developers.notion.com/cli/get-started/overview
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📝",
+        "requires": { "anyBins": ["ntn", "curl"] },
+        "primaryEnv": "NOTION_API_TOKEN",
+        "install":
+          [
+            {
+              "id": "node",
+              "kind": "node",
+              "package": "ntn",
+              "bins": ["ntn"],
+              "label": "Install official Notion CLI (npm)",
+            },
+          ],
+      },
+  }
+---
+
+# Notion
+
+Prefer official `ntn` CLI. Use curl only when `ntn` is unavailable or a raw request is clearer.
+
+## Setup
+
+```bash
+npm install -g ntn
+ntn --version
+ntn login
+```
+
+Script/headless auth:
+
+```bash
+export NOTION_API_TOKEN=secret_or_ntn_token
+export NOTION_API_VERSION=2026-03-11
+```
+
+`ntn api` sets `Authorization` and `Notion-Version` automatically. It uses CLI login by default, or `NOTION_API_TOKEN` when set.
+
+## Inspect
+
+```bash
+ntn doctor
+ntn api ls
+ntn api ls --json
+ntn api v1/comments --help
+ntn api v1/comments --spec -X POST
+ntn api v1/comments --docs -X POST
+```
+
+## Pages
+
+Markdown-first helpers:
+
+```bash
+ntn pages get <page-id>
+ntn pages get <page-id> --json
+ntn pages create --parent page:<page-id> --content '# Title\n\nBody'
+ntn pages create --parent data-source:<data-source-id> < page.md
+ntn pages update <page-id> --content '# Updated'
+ntn pages update <page-id> < page.md
+ntn pages trash <page-id> --yes
+```
+
+Notes:
+
+- `pages get` prints Markdown with page properties as frontmatter.
+- Content input: `--content`, stdin, or editor in a TTY.
+- Parent refs: `page:<id>`, `database:<id>`, `data-source:<id>`.
+- For properties/templates/full Pages API, use `ntn api v1/pages`.
+
+## Data sources
+
+```bash
+ntn datasources resolve <database-id>
+ntn datasources resolve <database-id> --json
+ntn datasources query <data-source-id>
+ntn datasources query <data-source-id> --limit 50 --json
+ntn datasources query <data-source-id> --sort 'Date desc'
+ntn datasources query <data-source-id> --filter '{"property":"Done","checkbox":{"equals":true}}'
+```
+
+Use `resolve` when you have a database ID. Query needs a data source ID.
+
+## Raw API
+
+```bash
+ntn api v1/users/me
+ntn api v1/search query=roadmap page_size:=10
+ntn api v1/pages 'parent[data_source_id]='"$DS_ID" 'properties[Name][title][0][text][content]=New item'
+ntn api "v1/pages/$PAGE_ID" -X PATCH in_trash:=true
+ntn api "v1/blocks/$PAGE_ID/children" -X PATCH \
+  'children[0][type]=paragraph' \
+  'children[0][paragraph][rich_text][0][text][content]=Hello'
+```
+
+Input syntax:
+
+- `path=value`: string body field.
+- `path:=json`: typed JSON body field.
+- `name==value`: query parameter.
+- `Header:Value`: request header.
+- `--data '<json>'` or stdin JSON for larger bodies.
+- Only one body source per request.
+
+## Files
+
+```bash
+ntn files create < image.png
+ntn files create --filename photo.png --content-type image/png < /tmp/photo
+ntn files create --external-url https://example.com/photo.png
+ntn files get <upload-id>
+ntn files list
+```
+
+## Workers
+
+```bash
+ntn workers new
+ntn workers deploy
+ntn workers list --json
+ntn workers runs list --json
+ntn workers runs logs <run-id>
+```
+
+Workers may require Business/Enterprise plan and workspace enablement.
+
+## Curl fallback
+
+```bash
+curl -sS "https://api.notion.com/v1/users/me" \
+  -H "Authorization: Bearer $NOTION_API_TOKEN" \
+  -H "Notion-Version: 2026-03-11" \
+  -H "Content-Type: application/json"
+```
+
+## Version notes
+
+- Current latest API version: `2026-03-11`.
+- Use `in_trash`, not `archived`.
+- Append block positioning uses `position`, not flat `after`.
+- `transcription` block renamed to `meeting_notes`.
+- Databases can contain multiple data sources; page parents generally use `data_source_id`.

package/skills/obsidian/SKILL.md

@@ -0,0 +1,119 @@
+---
+name: obsidian
+description: "Work with Obsidian vaults using the official obsidian CLI: read/search/create/edit notes, tasks, links, properties, plugins."
+homepage: https://obsidian.md/cli
+metadata: { "openclaw": { "emoji": "💎", "requires": { "bins": ["obsidian"] } } }
+---
+
+# Obsidian
+
+Use the official `obsidian` CLI for Obsidian vault work. Vault files are plain Markdown, so direct file edits are still fine when safer/faster.
+
+## Requirements
+
+- Obsidian 1.12.7+ installed.
+- Settings -> General -> Command line interface enabled.
+- `obsidian` registered on PATH.
+- Obsidian app running; the CLI connects to the running app.
+
+Check:
+
+```bash
+obsidian version
+obsidian help
+```
+
+macOS registration creates `/usr/local/bin/obsidian` pointing at the app-bundled CLI. Linux registration copies the binary to `~/.local/bin/obsidian`.
+
+## Vault model
+
+- Notes: `*.md`.
+- Config: `.obsidian/`; avoid editing unless asked.
+- Canvases: `*.canvas` JSON.
+- Attachments: vault-configured folder.
+- Multiple vaults are common; pass `vault="<name>"` when ambiguous.
+
+Obsidian desktop tracks vaults here:
+
+- `~/Library/Application Support/obsidian/obsidian.json`
+
+## Command pattern
+
+```bash
+obsidian <command> [name=value] [flag]
+obsidian vault="Notes" search query="meeting notes" format=json
+```
+
+Parameter values with spaces need quotes. Add `--copy` to copy output where useful.
+
+## Common commands
+
+Open/read:
+
+```bash
+obsidian open file=Recipe
+obsidian open path="Inbox/Idea.md" newtab
+obsidian read
+obsidian read file=Recipe
+```
+
+Search:
+
+```bash
+obsidian search query="TODO" matches
+obsidian search query="status::active" format=json
+obsidian search:open query="project notes"
+```
+
+Create/modify:
+
+```bash
+obsidian create name="New Note"
+obsidian create path="Inbox/Idea.md" content="# Idea"
+obsidian append file=Note content="New line"
+obsidian prepend file=Note content="After frontmatter"
+```
+
+Move/delete:
+
+```bash
+obsidian move file=Note to=Archive/
+obsidian move path="Inbox/Old.md" to="Projects/New.md"
+obsidian delete file=Note
+```
+
+Daily/tasks:
+
+```bash
+obsidian daily
+obsidian daily:read
+obsidian daily:append content="- [ ] Review inbox"
+obsidian tasks all todo
+obsidian task file=Note line=8 done
+```
+
+Properties/links:
+
+```bash
+obsidian tags all counts
+obsidian property:read file=Note name=status
+obsidian property:set file=Note name=status value=done
+obsidian backlinks file=Note
+obsidian unresolved verbose counts
+```
+
+Developer/debug:
+
+```bash
+obsidian plugin:reload my-plugin
+obsidian dev:errors
+obsidian dev:screenshot file=shot.png
+obsidian eval "app.vault.getFiles().length"
+```
+
+## Notes
+
+- `file=<name>` uses Obsidian-style file resolution; `path=<vault-relative.md>` is exact.
+- Prefer CLI move/delete/property commands for Obsidian-aware updates.
+- Prefer direct Markdown edits for bulk text changes after locating the vault path.
+- Do not rely on third-party `obsidian-cli` unless user explicitly asks for it.

package/skills/openai-whisper/SKILL.md

@@ -0,0 +1,38 @@
+---
+name: openai-whisper
+description: "Local speech-to-text with the Whisper CLI (no API key)."
+homepage: https://openai.com/research/whisper
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🎤",
+        "requires": { "bins": ["whisper"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "openai-whisper",
+              "bins": ["whisper"],
+              "label": "Install OpenAI Whisper (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# Whisper (CLI)
+
+Use `whisper` to transcribe audio locally.
+
+Quick start
+
+- `whisper /path/audio.mp3 --model medium --output_format txt --output_dir .`
+- `whisper /path/audio.m4a --task translate --output_format srt`
+
+Notes
+
+- Models download to `~/.cache/whisper` on first run.
+- `--model` defaults to `turbo` on this install.
+- Use smaller models for speed, larger for accuracy.

package/skills/openai-whisper-api/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: openai-whisper-api
+description: "OpenAI Audio Transcriptions API via curl; gpt-4o-transcribe, mini, diarize, or whisper-1."
+homepage: https://platform.openai.com/docs/guides/speech-to-text
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🌐",
+        "requires": { "bins": ["curl", "node"], "env": ["OPENAI_API_KEY"] },
+        "primaryEnv": "OPENAI_API_KEY",
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "curl",
+              "bins": ["curl"],
+              "label": "Install curl (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# OpenAI transcriptions API
+
+Transcribe audio through `/v1/audio/transcriptions`. Set `OPENAI_BASE_URL` for an OpenAI-compatible proxy or local gateway.
+
+## Quick start
+
+```bash
+{baseDir}/scripts/transcribe.sh /path/to/audio.m4a
+```
+
+Defaults:
+
+- Model: `gpt-4o-transcribe`
+- Output: `<input>.txt`
+
+## Useful flags
+
+```bash
+{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model gpt-4o-transcribe --out /tmp/transcript.txt
+{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model gpt-4o-mini-transcribe
+{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model gpt-4o-transcribe-diarize --json
+{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model whisper-1
+{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --language en
+{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --prompt "Speaker names: Peter, Daniel"
+{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --json --out /tmp/transcript.json
+```
+
+Notes:
+
+- Supported upload formats include `mp3`, `mp4`, `mpeg`, `mpga`, `m4a`, `wav`, `webm`.
+- 25 MB upload limit on the hosted API.
+- Use diarize for speaker labels; script sends `chunking_strategy=auto` and rejects `--prompt`.
+
+## API key
+
+Set `OPENAI_API_KEY`, or configure it in the active OpenClaw config file (`$OPENCLAW_CONFIG_PATH`, default `~/.openclaw/openclaw.json`). Optionally set `OPENAI_BASE_URL`:
+
+```json5
+{
+  skills: {
+    "openai-whisper-api": {
+      apiKey: "OPENAI_KEY_HERE",
+    },
+  },
+}
+```

package/skills/openai-whisper-api/scripts/transcribe.sh

@@ -0,0 +1,154 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat >&2 <<'EOF'
+Usage:
+  transcribe.sh <audio-file> [--model gpt-4o-transcribe] [--out /path/to/out.txt] [--language en] [--prompt "hint"] [--json]
+EOF
+  exit 2
+}
+
+if [[ "${1:-}" == "" || "${1:-}" == "-h" || "${1:-}" == "--help" ]]; then
+  usage
+fi
+
+in="${1:-}"
+shift || true
+
+model="gpt-4o-transcribe"
+out=""
+language=""
+prompt=""
+json_output=0
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --model)
+      model="${2:-}"
+      shift 2
+      ;;
+    --out)
+      out="${2:-}"
+      shift 2
+      ;;
+    --language)
+      language="${2:-}"
+      shift 2
+      ;;
+    --prompt)
+      prompt="${2:-}"
+      shift 2
+      ;;
+    --json)
+      json_output=1
+      shift 1
+      ;;
+    *)
+      echo "Unknown arg: $1" >&2
+      usage
+      ;;
+  esac
+done
+
+if [[ ! -f "$in" ]]; then
+  echo "File not found: $in" >&2
+  exit 1
+fi
+
+if [[ "${OPENAI_API_KEY:-}" == "" ]]; then
+  echo "Missing OPENAI_API_KEY" >&2
+  exit 1
+fi
+
+if [[ "$out" == "" ]]; then
+  base="${in%.*}"
+  if [[ "$json_output" == "1" ]]; then
+    out="${base}.json"
+  else
+    out="${base}.txt"
+  fi
+fi
+
+mkdir -p "$(dirname "$out")"
+
+api_base="${OPENAI_BASE_URL:-https://api.openai.com/v1}"
+api_base="${api_base%/}"
+
+request_format="text"
+if [[ "$json_output" == "1" ]]; then
+  request_format="json"
+fi
+
+diarize=0
+case "$model" in
+  gpt-4o-transcribe | gpt-4o-mini-transcribe | gpt-4o-mini-transcribe-*)
+    request_format="json"
+    ;;
+  gpt-4o-transcribe-diarize)
+    diarize=1
+    request_format="diarized_json"
+    ;;
+esac
+
+if [[ "$diarize" == "1" && "$prompt" != "" ]]; then
+  echo "--prompt is not supported with gpt-4o-transcribe-diarize" >&2
+  exit 2
+fi
+
+target="$out"
+tmp=""
+if [[ "$json_output" == "0" && ( "$request_format" == "json" || "$request_format" == "diarized_json" ) ]]; then
+  tmp="$(mktemp)"
+  trap '[[ "$tmp" == "" ]] || rm -f "$tmp"' EXIT
+  target="$tmp"
+fi
+
+curl_args=(
+  -sS "${api_base}/audio/transcriptions"
+  -H "Authorization: Bearer $OPENAI_API_KEY"
+  -H "Accept: application/json"
+  -F "file=@${in}"
+  -F "model=${model}"
+  -F "response_format=${request_format}"
+)
+if [[ "$language" != "" ]]; then
+  curl_args+=(-F "language=${language}")
+fi
+if [[ "$prompt" != "" ]]; then
+  curl_args+=(-F "prompt=${prompt}")
+fi
+if [[ "$diarize" == "1" ]]; then
+  curl_args+=(-F "chunking_strategy=auto")
+fi
+
+curl "${curl_args[@]}" >"$target"
+
+if [[ "$target" != "$out" ]]; then
+  node -e '
+const fs = require("fs");
+const input = process.argv[1];
+const output = process.argv[2];
+const payload = JSON.parse(fs.readFileSync(input, "utf8"));
+if (Array.isArray(payload.segments)) {
+  const lines = payload.segments
+    .map((segment) => {
+      const text = typeof segment?.text === "string" ? segment.text.trim() : "";
+      if (!text) return "";
+      const speaker = typeof segment?.speaker === "string" ? segment.speaker.trim() : "";
+      return speaker ? `${speaker}: ${text}` : text;
+    })
+    .filter(Boolean);
+  if (lines.length > 0) {
+    fs.writeFileSync(output, lines.join("\n"));
+    process.exit(0);
+  }
+}
+if (typeof payload.text !== "string") {
+  throw new Error("Transcription response missing text");
+}
+fs.writeFileSync(output, payload.text);
+' "$target" "$out"
+fi
+
+echo "$out"

package/skills/openhue/SKILL.md

@@ -0,0 +1,112 @@
+---
+name: openhue
+description: "Control Philips Hue lights and scenes via the OpenHue CLI."
+homepage: https://www.openhue.io/cli
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "💡",
+        "requires": { "bins": ["openhue"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "openhue/cli/openhue-cli",
+              "bins": ["openhue"],
+              "label": "Install OpenHue CLI (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# OpenHue CLI
+
+Use `openhue` to control Philips Hue lights and scenes via a Hue Bridge.
+
+## When to Use
+
+Use when:
+
+- "Turn on/off the lights"
+- "Dim the living room lights"
+- "Set a scene" or "movie mode"
+- Controlling specific Hue rooms or zones
+- Adjusting brightness, color, or color temperature
+
+## When NOT to Use
+
+Do not use when:
+
+- Non-Hue smart devices (other brands) -> not supported
+- HomeKit scenes or Shortcuts -> use Apple's ecosystem
+- TV or entertainment system control
+- Thermostat or HVAC
+- Smart plugs (unless Hue smart plugs)
+
+## Common Commands
+
+### List Resources
+
+```bash
+openhue get light       # List all lights
+openhue get room        # List all rooms
+openhue get scene       # List all scenes
+```
+
+### Control Lights
+
+```bash
+# Turn on/off
+openhue set light "Bedroom Lamp" --on
+openhue set light "Bedroom Lamp" --off
+
+# Brightness (0-100)
+openhue set light "Bedroom Lamp" --on --brightness 50
+
+# Color temperature (warm to cool: 153-500 mirek)
+openhue set light "Bedroom Lamp" --on --temperature 300
+
+# Color (by name or hex)
+openhue set light "Bedroom Lamp" --on --color red
+openhue set light "Bedroom Lamp" --on --rgb "#FF5500"
+```
+
+### Control Rooms
+
+```bash
+# Turn off entire room
+openhue set room "Bedroom" --off
+
+# Set room brightness
+openhue set room "Bedroom" --on --brightness 30
+```
+
+### Scenes
+
+```bash
+# Activate scene
+openhue set scene "Relax" --room "Bedroom"
+openhue set scene "Concentrate" --room "Office"
+```
+
+## Quick Presets
+
+```bash
+# Bedtime (dim warm)
+openhue set room "Bedroom" --on --brightness 20 --temperature 450
+
+# Work mode (bright cool)
+openhue set room "Office" --on --brightness 100 --temperature 250
+
+# Movie mode (dim)
+openhue set room "Living Room" --on --brightness 10
+```
+
+## Notes
+
+- Bridge must be on local network
+- First run requires button press on Hue bridge to pair
+- Colors only work on color-capable bulbs (not white-only)