chore: Also format scripts and skills.

skills/1password/SKILL.md

@@ -2,7 +2,24 @@
 name: 1password
 description: Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
 homepage: https://developer.1password.com/docs/cli/get-started/
-metadata: {"openclaw":{"emoji":"🔐","requires":{"bins":["op"]},"install":[{"id":"brew","kind":"brew","formula":"1password-cli","bins":["op"],"label":"Install 1Password CLI (brew)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🔐",
+        "requires": { "bins": ["op"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "1password-cli",
+              "bins": ["op"],
+              "label": "Install 1Password CLI (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # 1Password CLI

skills/apple-notes/SKILL.md

@@ -2,7 +2,25 @@
 name: apple-notes
 description: Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks OpenClaw to add a note, list notes, search notes, or manage note folders.
 homepage: https://github.com/antoniorodr/memo
-metadata: {"openclaw":{"emoji":"📝","os":["darwin"],"requires":{"bins":["memo"]},"install":[{"id":"brew","kind":"brew","formula":"antoniorodr/memo/memo","bins":["memo"],"label":"Install memo via Homebrew"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📝",
+        "os": ["darwin"],
+        "requires": { "bins": ["memo"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "antoniorodr/memo/memo",
+              "bins": ["memo"],
+              "label": "Install memo via Homebrew",
+            },
+          ],
+      },
+  }
 ---
 
 # Apple Notes CLI
@@ -10,41 +28,50 @@ metadata: {"openclaw":{"emoji":"📝","os":["darwin"],"requires":{"bins":["memo"
 Use `memo notes` to manage Apple Notes directly from the terminal. Create, view, edit, delete, search, move notes between folders, and export to HTML/Markdown.
 
 Setup
+
 - Install (Homebrew): `brew tap antoniorodr/memo && brew install antoniorodr/memo/memo`
 - Manual (pip): `pip install .` (after cloning the repo)
 - macOS-only; if prompted, grant Automation access to Notes.app.
 
 View Notes
+
 - List all notes: `memo notes`
 - Filter by folder: `memo notes -f "Folder Name"`
 - Search notes (fuzzy): `memo notes -s "query"`
 
 Create Notes
+
 - Add a new note: `memo notes -a`
   - Opens an interactive editor to compose the note.
 - Quick add with title: `memo notes -a "Note Title"`
 
 Edit Notes
+
 - Edit existing note: `memo notes -e`
   - Interactive selection of note to edit.
 
 Delete Notes
+
 - Delete a note: `memo notes -d`
   - Interactive selection of note to delete.
 
 Move Notes
+
 - Move note to folder: `memo notes -m`
   - Interactive selection of note and destination folder.
 
 Export Notes
+
 - Export to HTML/Markdown: `memo notes -ex`
   - Exports selected note; uses Mistune for markdown processing.
 
 Limitations
+
 - Cannot edit notes containing images or attachments.
 - Interactive prompts may require terminal access.
 
 Notes
+
 - macOS-only.
 - Requires Apple Notes.app to be accessible.
 - For automation, grant permissions in System Settings > Privacy & Security > Automation.

skills/apple-reminders/SKILL.md

@@ -2,7 +2,25 @@
 name: apple-reminders
 description: Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
 homepage: https://github.com/steipete/remindctl
-metadata: {"openclaw":{"emoji":"⏰","os":["darwin"],"requires":{"bins":["remindctl"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/remindctl","bins":["remindctl"],"label":"Install remindctl via Homebrew"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "⏰",
+        "os": ["darwin"],
+        "requires": { "bins": ["remindctl"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/remindctl",
+              "bins": ["remindctl"],
+              "label": "Install remindctl via Homebrew",
+            },
+          ],
+      },
+  }
 ---
 
 # Apple Reminders CLI (remindctl)
@@ -10,15 +28,18 @@ metadata: {"openclaw":{"emoji":"⏰","os":["darwin"],"requires":{"bins":["remind
 Use `remindctl` to manage Apple Reminders directly from the terminal. It supports list filtering, date-based views, and scripting output.
 
 Setup
+
 - Install (Homebrew): `brew install steipete/tap/remindctl`
 - From source: `pnpm install && pnpm build` (binary at `./bin/remindctl`)
 - macOS-only; grant Reminders permission when prompted.
 
 Permissions
+
 - Check status: `remindctl status`
 - Request access: `remindctl authorize`
 
 View Reminders
+
 - Default (today): `remindctl`
 - Today: `remindctl today`
 - Tomorrow: `remindctl tomorrow`
@@ -30,6 +51,7 @@ View Reminders
 - Specific date: `remindctl 2026-01-04`
 
 Manage Lists
+
 - List all lists: `remindctl list`
 - Show list: `remindctl list Work`
 - Create list: `remindctl list Projects --create`
@@ -37,31 +59,38 @@ Manage Lists
 - Delete list: `remindctl list Work --delete`
 
 Create Reminders
+
 - Quick add: `remindctl add "Buy milk"`
 - With list + due: `remindctl add --title "Call mom" --list Personal --due tomorrow`
 
 Edit Reminders
+
 - Edit title/due: `remindctl edit 1 --title "New title" --due 2026-01-04`
 
 Complete Reminders
+
 - Complete by id: `remindctl complete 1 2 3`
 
 Delete Reminders
+
 - Delete by id: `remindctl delete 4A83 --force`
 
 Output Formats
+
 - JSON (scripting): `remindctl today --json`
 - Plain TSV: `remindctl today --plain`
 - Counts only: `remindctl today --quiet`
 
 Date Formats
 Accepted by `--due` and date filters:
+
 - `today`, `tomorrow`, `yesterday`
 - `YYYY-MM-DD`
 - `YYYY-MM-DD HH:mm`
 - ISO 8601 (`2026-01-04T12:34:56Z`)
 
 Notes
+
 - macOS-only.
 - If access is denied, enable Terminal/remindctl in System Settings → Privacy & Security → Reminders.
 - If running over SSH, grant access on the Mac that runs the command.

skills/bear-notes/SKILL.md

@@ -2,7 +2,25 @@
 name: bear-notes
 description: Create, search, and manage Bear notes via grizzly CLI.
 homepage: https://bear.app
-metadata: {"openclaw":{"emoji":"🐻","os":["darwin"],"requires":{"bins":["grizzly"]},"install":[{"id":"go","kind":"go","module":"github.com/tylerwince/grizzly/cmd/grizzly@latest","bins":["grizzly"],"label":"Install grizzly (go)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🐻",
+        "os": ["darwin"],
+        "requires": { "bins": ["grizzly"] },
+        "install":
+          [
+            {
+              "id": "go",
+              "kind": "go",
+              "module": "github.com/tylerwince/grizzly/cmd/grizzly@latest",
+              "bins": ["grizzly"],
+              "label": "Install grizzly (go)",
+            },
+          ],
+      },
+  }
 ---
 
 # Bear Notes
@@ -10,39 +28,46 @@ metadata: {"openclaw":{"emoji":"🐻","os":["darwin"],"requires":{"bins":["grizz
 Use `grizzly` to create, read, and manage notes in Bear on macOS.
 
 Requirements
+
 - Bear app installed and running
 - For some operations (add-text, tags, open-note --selected), a Bear app token (stored in `~/.config/grizzly/token`)
 
 ## Getting a Bear Token
 
 For operations that require a token (add-text, tags, open-note --selected), you need an authentication token:
+
 1. Open Bear → Help → API Token → Copy Token
 2. Save it: `echo "YOUR_TOKEN" > ~/.config/grizzly/token`
 
 ## Common Commands
 
 Create a note
+
 ```bash
 echo "Note content here" | grizzly create --title "My Note" --tag work
 grizzly create --title "Quick Note" --tag inbox < /dev/null
 ```
 
 Open/read a note by ID
+
 ```bash
 grizzly open-note --id "NOTE_ID" --enable-callback --json
 ```
 
 Append text to a note
+
 ```bash
 echo "Additional content" | grizzly add-text --id "NOTE_ID" --mode append --token-file ~/.config/grizzly/token
 ```
 
 List all tags
+
 ```bash
 grizzly tags --enable-callback --json --token-file ~/.config/grizzly/token
 ```
 
 Search notes (via open-tag)
+
 ```bash
 grizzly open-tag --name "work" --enable-callback --json
 ```
@@ -50,6 +75,7 @@ grizzly open-tag --name "work" --enable-callback --json
 ## Options
 
 Common flags:
+
 - `--dry-run` — Preview the URL without executing
 - `--print-url` — Show the x-callback-url
 - `--enable-callback` — Wait for Bear's response (needed for reading data)
@@ -59,12 +85,14 @@ Common flags:
 ## Configuration
 
 Grizzly reads config from (in priority order):
+
 1. CLI flags
 2. Environment variables (`GRIZZLY_TOKEN_FILE`, `GRIZZLY_CALLBACK_URL`, `GRIZZLY_TIMEOUT`)
 3. `.grizzly.toml` in current directory
 4. `~/.config/grizzly/config.toml`
 
 Example `~/.config/grizzly/config.toml`:
+
 ```toml
 token_file = "~/.config/grizzly/token"
 callback_url = "http://127.0.0.1:42123/success"

skills/bird/SKILL.md

@@ -2,7 +2,32 @@
 name: bird
 description: X/Twitter CLI for reading, searching, posting, and engagement via cookies.
 homepage: https://bird.fast
-metadata: {"openclaw":{"emoji":"🐦","requires":{"bins":["bird"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/bird","bins":["bird"],"label":"Install bird (brew)","os":["darwin"]},{"id":"npm","kind":"node","package":"@steipete/bird","bins":["bird"],"label":"Install bird (npm)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🐦",
+        "requires": { "bins": ["bird"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/bird",
+              "bins": ["bird"],
+              "label": "Install bird (brew)",
+              "os": ["darwin"],
+            },
+            {
+              "id": "npm",
+              "kind": "node",
+              "package": "@steipete/bird",
+              "bins": ["bird"],
+              "label": "Install bird (npm)",
+            },
+          ],
+      },
+  }
 ---
 
 # bird 🐦
@@ -174,7 +199,7 @@ bird replies <id> --all --delay 1000    # Delay between pages (ms)
   cookieSource: ["chrome"],
   chromeProfileDir: "/path/to/Arc/Profile",
   timeoutMs: 20000,
-  quoteDepth: 1
+  quoteDepth: 1,
 }
 ```
 
@@ -183,11 +208,13 @@ Environment variables: `BIRD_TIMEOUT_MS`, `BIRD_COOKIE_TIMEOUT_MS`, `BIRD_QUOTE_
 ## Troubleshooting
 
 ### Query IDs stale (404 errors)
+
 ```bash
 bird query-ids --fresh
 ```
 
 ### Cookie extraction fails
+
 - Check browser is logged into X
 - Try different `--cookie-source`
 - For Arc/Brave: use `--chrome-profile-dir`

skills/blogwatcher/SKILL.md

@@ -2,7 +2,24 @@
 name: blogwatcher
 description: Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.
 homepage: https://github.com/Hyaxia/blogwatcher
-metadata: {"openclaw":{"emoji":"📰","requires":{"bins":["blogwatcher"]},"install":[{"id":"go","kind":"go","module":"github.com/Hyaxia/blogwatcher/cmd/blogwatcher@latest","bins":["blogwatcher"],"label":"Install blogwatcher (go)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📰",
+        "requires": { "bins": ["blogwatcher"] },
+        "install":
+          [
+            {
+              "id": "go",
+              "kind": "go",
+              "module": "github.com/Hyaxia/blogwatcher/cmd/blogwatcher@latest",
+              "bins": ["blogwatcher"],
+              "label": "Install blogwatcher (go)",
+            },
+          ],
+      },
+  }
 ---
 
 # blogwatcher
@@ -10,12 +27,15 @@ metadata: {"openclaw":{"emoji":"📰","requires":{"bins":["blogwatcher"]},"insta
 Track blog and RSS/Atom feed updates with the `blogwatcher` CLI.
 
 Install
+
 - Go: `go install github.com/Hyaxia/blogwatcher/cmd/blogwatcher@latest`
 
 Quick start
+
 - `blogwatcher --help`
 
 Common commands
+
 - Add a blog: `blogwatcher add "My Blog" https://example.com`
 - List blogs: `blogwatcher blogs`
 - Scan for updates: `blogwatcher scan`
@@ -25,6 +45,7 @@ Common commands
 - Remove a blog: `blogwatcher remove "My Blog"`
 
 Example output
+
 ```
 $ blogwatcher blogs
 Tracked blogs (1):
@@ -32,6 +53,7 @@ Tracked blogs (1):
   xkcd
     URL: https://xkcd.com
 ```
+
 ```
 $ blogwatcher scan
 Scanning 1 blog(s)...
@@ -43,4 +65,5 @@ Found 4 new article(s) total!
 ```
 
 Notes
+
 - Use `blogwatcher <command> --help` to discover flags and options.

skills/blucli/SKILL.md

@@ -2,7 +2,24 @@
 name: blucli
 description: BluOS CLI (blu) for discovery, playback, grouping, and volume.
 homepage: https://blucli.sh
-metadata: {"openclaw":{"emoji":"🫐","requires":{"bins":["blu"]},"install":[{"id":"go","kind":"go","module":"github.com/steipete/blucli/cmd/blu@latest","bins":["blu"],"label":"Install blucli (go)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🫐",
+        "requires": { "bins": ["blu"] },
+        "install":
+          [
+            {
+              "id": "go",
+              "kind": "go",
+              "module": "github.com/steipete/blucli/cmd/blu@latest",
+              "bins": ["blu"],
+              "label": "Install blucli (go)",
+            },
+          ],
+      },
+  }
 ---
 
 # blucli (blu)
@@ -10,17 +27,20 @@ metadata: {"openclaw":{"emoji":"🫐","requires":{"bins":["blu"]},"install":[{"i
 Use `blu` to control Bluesound/NAD players.
 
 Quick start
+
 - `blu devices` (pick target)
 - `blu --device <id> status`
 - `blu play|pause|stop`
 - `blu volume set 15`
 
 Target selection (in priority order)
+
 - `--device <id|name|alias>`
 - `BLU_DEVICE`
 - config default (if set)
 
 Common tasks
+
 - Grouping: `blu group status|add|remove`
 - TuneIn search/play: `blu tunein search "query"`, `blu tunein play "query"`
 

skills/bluebubbles/SKILL.md

@@ -8,6 +8,7 @@ description: Build or update the BlueBubbles external channel plugin for OpenCla
 Use this skill when working on the BlueBubbles channel plugin.
 
 ## Layout
+
 - Extension package: `extensions/bluebubbles/` (entry: `index.ts`).
 - Channel implementation: `extensions/bluebubbles/src/channel.ts`.
 - Webhook handling: `extensions/bluebubbles/src/monitor.ts` (register via `api.registerHttpHandler`).
@@ -16,6 +17,7 @@ Use this skill when working on the BlueBubbles channel plugin.
 - Catalog entry for onboarding: `src/channels/plugins/catalog.ts`.
 
 ## Internal helpers (use these, not raw API calls)
+
 - `probeBlueBubbles` in `extensions/bluebubbles/src/probe.ts` for health checks.
 - `sendMessageBlueBubbles` in `extensions/bluebubbles/src/send.ts` for text delivery.
 - `resolveChatGuidForTarget` in `extensions/bluebubbles/src/send.ts` for chat lookup.
@@ -25,6 +27,7 @@ Use this skill when working on the BlueBubbles channel plugin.
 - `buildBlueBubblesApiUrl` + `blueBubblesFetchWithTimeout` in `extensions/bluebubbles/src/types.ts` for shared REST plumbing.
 
 ## Webhooks
+
 - BlueBubbles posts JSON to the gateway HTTP server.
 - Normalize sender/chat IDs defensively (payloads vary by version).
 - Skip messages marked as from self.
@@ -32,8 +35,10 @@ Use this skill when working on the BlueBubbles channel plugin.
 - For attachments/stickers, use `<media:...>` placeholders when text is empty and attach media paths via `MediaUrl(s)` in the inbound context.
 
 ## Config (core)
+
 - `channels.bluebubbles.serverUrl` (base URL), `channels.bluebubbles.password`, `channels.bluebubbles.webhookPath`.
 - Action gating: `channels.bluebubbles.actions.reactions` (default true).
 
 ## Message tool notes
+
 - **Reactions:** The `react` action requires a `target` (phone number or chat identifier) in addition to `messageId`. Example: `action=react target=+15551234567 messageId=ABC123 emoji=❤️`

skills/camsnap/SKILL.md

@@ -2,7 +2,24 @@
 name: camsnap
 description: Capture frames or clips from RTSP/ONVIF cameras.
 homepage: https://camsnap.ai
-metadata: {"openclaw":{"emoji":"📸","requires":{"bins":["camsnap"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/camsnap","bins":["camsnap"],"label":"Install camsnap (brew)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📸",
+        "requires": { "bins": ["camsnap"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/camsnap",
+              "bins": ["camsnap"],
+              "label": "Install camsnap (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # camsnap
@@ -10,10 +27,12 @@ metadata: {"openclaw":{"emoji":"📸","requires":{"bins":["camsnap"]},"install":
 Use `camsnap` to grab snapshots, clips, or motion events from configured cameras.
 
 Setup
+
 - Config file: `~/.config/camsnap/config.yaml`
 - Add camera: `camsnap add --name kitchen --host 192.168.0.10 --user user --pass pass`
 
 Common commands
+
 - Discover: `camsnap discover --info`
 - Snapshot: `camsnap snap kitchen --out shot.jpg`
 - Clip: `camsnap clip kitchen --dur 5s --out clip.mp4`
@@ -21,5 +40,6 @@ Common commands
 - Doctor: `camsnap doctor --probe`
 
 Notes
+
 - Requires `ffmpeg` on PATH.
 - Prefer a short test capture before longer clips.

skills/canvas/SKILL.md

@@ -5,6 +5,7 @@ Display HTML content on connected OpenClaw nodes (Mac app, iOS, Android).
 ## Overview
 
 The canvas tool lets you present web content on any connected node's canvas view. Great for:
+
 - Displaying games, visualizations, dashboards
 - Showing generated HTML content
 - Interactive demos
@@ -29,14 +30,15 @@ The canvas tool lets you present web content on any connected node's canvas view
 
 The canvas host server binds based on `gateway.bind` setting:
 
-| Bind Mode | Server Binds To | Canvas URL Uses |
-|-----------|-----------------|-----------------|
-| `loopback` | 127.0.0.1 | localhost (local only) |
-| `lan` | LAN interface | LAN IP address |
-| `tailnet` | Tailscale interface | Tailscale hostname |
-| `auto` | Best available | Tailscale > LAN > loopback |
+| Bind Mode  | Server Binds To     | Canvas URL Uses            |
+| ---------- | ------------------- | -------------------------- |
+| `loopback` | 127.0.0.1           | localhost (local only)     |
+| `lan`      | LAN interface       | LAN IP address             |
+| `tailnet`  | Tailscale interface | Tailscale hostname         |
+| `auto`     | Best available      | Tailscale > LAN > loopback |
 
 **Key insight:** The `canvasHostHostForBridge` is derived from `bridgeHost`. When bound to Tailscale, nodes receive URLs like:
+
 ```
 http://<tailscale-hostname>:18793/__moltbot__/canvas/<file>.html
 ```
@@ -45,13 +47,13 @@ This is why localhost URLs don't work - the node receives the Tailscale hostname
 
 ## Actions
 
-| Action | Description |
-|--------|-------------|
-| `present` | Show canvas with optional target URL |
-| `hide` | Hide the canvas |
-| `navigate` | Navigate to a new URL |
-| `eval` | Execute JavaScript in the canvas |
-| `snapshot` | Capture screenshot of canvas |
+| Action     | Description                          |
+| ---------- | ------------------------------------ |
+| `present`  | Show canvas with optional target URL |
+| `hide`     | Hide the canvas                      |
+| `navigate` | Navigate to a new URL                |
+| `eval`     | Execute JavaScript in the canvas     |
+| `snapshot` | Capture screenshot of canvas         |
 
 ## Configuration
 
@@ -74,6 +76,7 @@ In `~/.openclaw/openclaw.json`:
 ### Live Reload
 
 When `liveReload: true` (default), the canvas host:
+
 - Watches the root directory for changes (via chokidar)
 - Injects a WebSocket client into HTML files
 - Automatically reloads connected canvases when files change
@@ -101,15 +104,18 @@ HTML
 ### 2. Find your canvas host URL
 
 Check how your gateway is bound:
+
 ```bash
 cat ~/.openclaw/openclaw.json | jq '.gateway.bind'
 ```
 
 Then construct the URL:
+
 - **loopback**: `http://127.0.0.1:18793/__moltbot__/canvas/<file>.html`
 - **lan/tailnet/auto**: `http://<hostname>:18793/__moltbot__/canvas/<file>.html`
 
 Find your Tailscale hostname:
+
 ```bash
 tailscale status --json | jq -r '.Self.DNSName' | sed 's/\.$//'
 ```
@@ -129,6 +135,7 @@ canvas action:present node:<node-id> target:<full-url>
 ```
 
 **Example:**
+
 ```
 canvas action:present node:mac-63599bc4-b54d-4392-9048-b97abd58343a target:http://peters-mac-studio-1.sheep-coho.ts.net:18793/__moltbot__/canvas/snake.html
 ```
@@ -148,6 +155,7 @@ canvas action:hide node:<node-id>
 **Cause:** URL mismatch between server bind and node expectation.
 
 **Debug steps:**
+
 1. Check server bind: `cat ~/.openclaw/openclaw.json | jq '.gateway.bind'`
 2. Check what port canvas is on: `lsof -i :18793`
 3. Test URL directly: `curl http://<hostname>:18793/__moltbot__/canvas/<file>.html`
@@ -165,6 +173,7 @@ Node is offline. Use `openclaw nodes list` to find online nodes.
 ### Content not updating
 
 If live reload isn't working:
+
 1. Check `liveReload: true` in config
 2. Ensure file is in the canvas root directory
 3. Check for watcher errors in logs

skills/clawhub/SKILL.md

@@ -1,34 +1,55 @@
 ---
 name: clawhub
 description: Use the ClawHub CLI to search, install, update, and publish agent skills from clawhub.com. Use when you need to fetch new skills on the fly, sync installed skills to latest or a specific version, or publish new/updated skill folders with the npm-installed clawhub CLI.
-metadata: {"openclaw":{"requires":{"bins":["clawhub"]},"install":[{"id":"node","kind":"node","package":"clawhub","bins":["clawhub"],"label":"Install ClawHub CLI (npm)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "requires": { "bins": ["clawhub"] },
+        "install":
+          [
+            {
+              "id": "node",
+              "kind": "node",
+              "package": "clawhub",
+              "bins": ["clawhub"],
+              "label": "Install ClawHub CLI (npm)",
+            },
+          ],
+      },
+  }
 ---
 
 # ClawHub CLI
 
 Install
+
 ```bash
 npm i -g clawhub
 ```
 
 Auth (publish)
+
 ```bash
 clawhub login
 clawhub whoami
 ```
 
 Search
+
 ```bash
 clawhub search "postgres backups"
 ```
 
 Install
+
 ```bash
 clawhub install my-skill
 clawhub install my-skill --version 1.2.3
 ```
 
 Update (hash-based match + upgrade)
+
 ```bash
 clawhub update my-skill
 clawhub update my-skill --version 1.2.3
@@ -38,16 +59,19 @@ clawhub update --all --no-input --force
 ```
 
 List
+
 ```bash
 clawhub list
 ```
 
 Publish
+
 ```bash
 clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.2.0 --changelog "Fixes + docs"
 ```
 
 Notes
+
 - Default registry: https://clawhub.com (override with CLAWHUB_REGISTRY or --registry)
 - Default workdir: cwd (falls back to OpenClaw workspace); install dir: ./skills (override with --workdir / --dir / CLAWHUB_WORKDIR)
 - Update command hashes local files, resolves matching version, and upgrades to latest unless --version is set

skills/coding-agent/SKILL.md

@@ -1,7 +1,10 @@
 ---
 name: coding-agent
 description: Run Codex CLI, Claude Code, OpenCode, or Pi Coding Agent via background process for programmatic control.
-metadata: {"openclaw":{"emoji":"🧩","requires":{"anyBins":["claude","codex","opencode","pi"]}}}
+metadata:
+  {
+    "openclaw": { "emoji": "🧩", "requires": { "anyBins": ["claude", "codex", "opencode", "pi"] } },
+  }
 ---
 
 # Coding Agent (bash-first)
@@ -24,27 +27,27 @@ bash command:"codex exec 'Your prompt'"
 
 ### Bash Tool Parameters
 
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `command` | string | The shell command to run |
-| `pty` | boolean | **Use for coding agents!** Allocates a pseudo-terminal for interactive CLIs |
-| `workdir` | string | Working directory (agent sees only this folder's context) |
-| `background` | boolean | Run in background, returns sessionId for monitoring |
-| `timeout` | number | Timeout in seconds (kills process on expiry) |
-| `elevated` | boolean | Run on host instead of sandbox (if allowed) |
+| Parameter    | Type    | Description                                                                 |
+| ------------ | ------- | --------------------------------------------------------------------------- |
+| `command`    | string  | The shell command to run                                                    |
+| `pty`        | boolean | **Use for coding agents!** Allocates a pseudo-terminal for interactive CLIs |
+| `workdir`    | string  | Working directory (agent sees only this folder's context)                   |
+| `background` | boolean | Run in background, returns sessionId for monitoring                         |
+| `timeout`    | number  | Timeout in seconds (kills process on expiry)                                |
+| `elevated`   | boolean | Run on host instead of sandbox (if allowed)                                 |
 
 ### Process Tool Actions (for background sessions)
 
-| Action | Description |
-|--------|-------------|
-| `list` | List all running/recent sessions |
-| `poll` | Check if session is still running |
-| `log` | Get session output (with optional offset/limit) |
-| `write` | Send raw data to stdin |
-| `submit` | Send data + newline (like typing and pressing Enter) |
-| `send-keys` | Send key tokens or hex bytes |
-| `paste` | Paste text (with optional bracketed mode) |
-| `kill` | Terminate the session |
+| Action      | Description                                          |
+| ----------- | ---------------------------------------------------- |
+| `list`      | List all running/recent sessions                     |
+| `poll`      | Check if session is still running                    |
+| `log`       | Get session output (with optional offset/limit)      |
+| `write`     | Send raw data to stdin                               |
+| `submit`    | Send data + newline (like typing and pressing Enter) |
+| `send-keys` | Send key tokens or hex bytes                         |
+| `paste`     | Paste text (with optional bracketed mode)            |
+| `kill`      | Terminate the session                                |
 
 ---
 
@@ -99,13 +102,14 @@ process action:kill sessionId:XXX
 
 ### Flags
 
-| Flag | Effect |
-|------|--------|
-| `exec "prompt"` | One-shot execution, exits when done |
-| `--full-auto` | Sandboxed but auto-approves in workspace |
-| `--yolo` | NO sandbox, NO approvals (fastest, most dangerous) |
+| Flag            | Effect                                             |
+| --------------- | -------------------------------------------------- |
+| `exec "prompt"` | One-shot execution, exits when done                |
+| `--full-auto`   | Sandboxed but auto-approves in workspace           |
+| `--yolo`        | NO sandbox, NO approvals (fastest, most dangerous) |
 
 ### Building/Creating
+
 ```bash
 # Quick one-shot (auto-approves) - remember PTY!
 bash pty:true workdir:~/project command:"codex exec --full-auto 'Build a dark mode toggle'"
@@ -133,6 +137,7 @@ bash pty:true workdir:/tmp/pr-130-review command:"codex review --base main"
 ```
 
 ### Batch PR Reviews (parallel army!)
+
 ```bash
 # Fetch all PR refs first
 git fetch origin '+refs/pull/*/head:refs/remotes/origin/pr/*'
@@ -259,6 +264,7 @@ openclaw gateway wake --text "Done: [brief summary of what was built]" --mode no
 ```
 
 **Example:**
+
 ```bash
 bash pty:true workdir:~/project background:true command:"codex --yolo exec 'Build a REST API for todos.
 
@@ -275,4 +281,4 @@ This triggers an immediate wake event — Skippy gets pinged in seconds, not 10
 - **Git repo required:** Codex won't run outside a git directory. Use `mktemp -d && git init` for scratch work.
 - **exec is your friend:** `codex exec "prompt"` runs and exits cleanly - perfect for one-shots.
 - **submit vs write:** Use `submit` to send input + Enter, `write` for raw data without newline.
-- **Sass works:** Codex responds well to playful prompts. Asked it to write a haiku about being second fiddle to a space lobster, got: *"Second chair, I code / Space lobster sets the tempo / Keys glow, I follow"* 🦞
+- **Sass works:** Codex responds well to playful prompts. Asked it to write a haiku about being second fiddle to a space lobster, got: _"Second chair, I code / Space lobster sets the tempo / Keys glow, I follow"_ 🦞

skills/discord/SKILL.md

@@ -131,6 +131,7 @@ Message context lines include `discord message id` and `channel` fields you can
 ## Action gating
 
 Use `discord.actions.*` to disable action groups:
+
 - `reactions` (react + reactions list + emojiList)
 - `stickers`, `polls`, `permissions`, `messages`, `threads`, `pins`, `search`
 - `emojiUploads`, `stickerUploads`
@@ -138,6 +139,7 @@ Use `discord.actions.*` to disable action groups:
 - `roles` (role add/remove, default `false`)
 - `channels` (channel/category create/edit/delete/move, default `false`)
 - `moderation` (timeout/kick/ban, default `false`)
+
 ### Read recent messages
 
 ```json
@@ -435,6 +437,7 @@ Create, edit, delete, and move channels and categories. Enable via `discord.acti
 **Keep it conversational!** Discord is a chat platform, not documentation.
 
 ### Do
+
 - Short, punchy messages (1-3 sentences ideal)
 - Multiple quick replies > one wall of text
 - Use emoji for tone/emphasis 🦞
@@ -443,6 +446,7 @@ Create, edit, delete, and move channels and categories. Enable via `discord.acti
 - Match the energy of the conversation
 
 ### Don't
+
 - No markdown tables (Discord renders them as ugly raw `| text |`)
 - No `## Headers` for casual chat (use **bold** or CAPS for emphasis)
 - Avoid multi-paragraph essays
@@ -450,6 +454,7 @@ Create, edit, delete, and move channels and categories. Enable via `discord.acti
 - Skip the "I'd be happy to help!" fluff
 
 ### Formatting that works
+
 - **bold** for emphasis
 - `code` for technical terms
 - Lists for multiple items
@@ -459,6 +464,7 @@ Create, edit, delete, and move channels and categories. Enable via `discord.acti
 ### Example transformations
 
 ❌ Bad:
+
 ```
 I'd be happy to help with that! Here's a comprehensive overview of the versioning strategies available:
 
@@ -470,6 +476,7 @@ CalVer uses date-based versions like...
 ```
 
 ✅ Good:
+
 ```
 versioning options: semver (1.2.3), calver (2026.01.04), or yolo (`latest` forever). what fits your release cadence?
 ```

skills/eightctl/SKILL.md

@@ -2,7 +2,24 @@
 name: eightctl
 description: Control Eight Sleep pods (status, temperature, alarms, schedules).
 homepage: https://eightctl.sh
-metadata: {"openclaw":{"emoji":"🎛️","requires":{"bins":["eightctl"]},"install":[{"id":"go","kind":"go","module":"github.com/steipete/eightctl/cmd/eightctl@latest","bins":["eightctl"],"label":"Install eightctl (go)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🎛️",
+        "requires": { "bins": ["eightctl"] },
+        "install":
+          [
+            {
+              "id": "go",
+              "kind": "go",
+              "module": "github.com/steipete/eightctl/cmd/eightctl@latest",
+              "bins": ["eightctl"],
+              "label": "Install eightctl (go)",
+            },
+          ],
+      },
+  }
 ---
 
 # eightctl
@@ -10,20 +27,24 @@ metadata: {"openclaw":{"emoji":"🎛️","requires":{"bins":["eightctl"]},"insta
 Use `eightctl` for Eight Sleep pod control. Requires auth.
 
 Auth
+
 - Config: `~/.config/eightctl/config.yaml`
 - Env: `EIGHTCTL_EMAIL`, `EIGHTCTL_PASSWORD`
 
 Quick start
+
 - `eightctl status`
 - `eightctl on|off`
 - `eightctl temp 20`
 
 Common tasks
+
 - Alarms: `eightctl alarm list|create|dismiss`
 - Schedules: `eightctl schedule list|create|update`
 - Audio: `eightctl audio state|play|pause`
 - Base: `eightctl base info|angle`
 
 Notes
+
 - API is unofficial and rate-limited; avoid repeated logins.
 - Confirm before changing temperature or alarms.

skills/food-order/SKILL.md

@@ -10,32 +10,39 @@ metadata: {"openclaw":{"emoji":"🥡","requires":{"bins":["ordercli"]},"install"
 Goal: reorder a previous Foodora order safely (preview first; confirm only on explicit user “yes/confirm/place the order”).
 
 Hard safety rules
+
 - Never run `ordercli foodora reorder ... --confirm` unless user explicitly confirms placing the order.
 - Prefer preview-only steps first; show what will happen; ask for confirmation.
 - If user is unsure: stop at preview and ask questions.
 
 Setup (once)
+
 - Country: `ordercli foodora countries` → `ordercli foodora config set --country AT`
 - Login (password): `ordercli foodora login --email you@example.com --password-stdin`
 - Login (no password, preferred): `ordercli foodora session chrome --url https://www.foodora.at/ --profile "Default"`
 
 Find what to reorder
+
 - Recent list: `ordercli foodora history --limit 10`
 - Details: `ordercli foodora history show <orderCode>`
 - If needed (machine-readable): `ordercli foodora history show <orderCode> --json`
 
 Preview reorder (no cart changes)
+
 - `ordercli foodora reorder <orderCode>`
 
 Place reorder (cart change; explicit confirmation required)
+
 - Confirm first, then run: `ordercli foodora reorder <orderCode> --confirm`
 - Multiple addresses? Ask user for the right `--address-id` (take from their Foodora account / prior order data) and run:
   - `ordercli foodora reorder <orderCode> --confirm --address-id <id>`
 
 Track the order
+
 - ETA/status (active list): `ordercli foodora orders`
 - Live updates: `ordercli foodora orders --watch`
 - Single order detail: `ordercli foodora order <orderCode>`
 
 Debug / safe testing
+
 - Use a throwaway config: `ordercli --config /tmp/ordercli.json ...`

skills/gemini/SKILL.md

@@ -2,7 +2,24 @@
 name: gemini
 description: Gemini CLI for one-shot Q&A, summaries, and generation.
 homepage: https://ai.google.dev/
-metadata: {"openclaw":{"emoji":"♊️","requires":{"bins":["gemini"]},"install":[{"id":"brew","kind":"brew","formula":"gemini-cli","bins":["gemini"],"label":"Install Gemini CLI (brew)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "♊️",
+        "requires": { "bins": ["gemini"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "gemini-cli",
+              "bins": ["gemini"],
+              "label": "Install Gemini CLI (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # Gemini CLI
@@ -10,14 +27,17 @@ metadata: {"openclaw":{"emoji":"♊️","requires":{"bins":["gemini"]},"install"
 Use Gemini in one-shot mode with a positional prompt (avoid interactive mode).
 
 Quick start
+
 - `gemini "Answer this question..."`
 - `gemini --model <name> "Prompt..."`
 - `gemini --output-format json "Return JSON"`
 
 Extensions
+
 - List: `gemini --list-extensions`
 - Manage: `gemini extensions <command>`
 
 Notes
+
 - If auth is required, run `gemini` once interactively and follow the login flow.
 - Avoid `--yolo` for safety.

skills/gifgrep/SKILL.md

@@ -2,7 +2,31 @@
 name: gifgrep
 description: Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
 homepage: https://gifgrep.com
-metadata: {"openclaw":{"emoji":"🧲","requires":{"bins":["gifgrep"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/gifgrep","bins":["gifgrep"],"label":"Install gifgrep (brew)"},{"id":"go","kind":"go","module":"github.com/steipete/gifgrep/cmd/gifgrep@latest","bins":["gifgrep"],"label":"Install gifgrep (go)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🧲",
+        "requires": { "bins": ["gifgrep"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/gifgrep",
+              "bins": ["gifgrep"],
+              "label": "Install gifgrep (brew)",
+            },
+            {
+              "id": "go",
+              "kind": "go",
+              "module": "github.com/steipete/gifgrep/cmd/gifgrep@latest",
+              "bins": ["gifgrep"],
+              "label": "Install gifgrep (go)",
+            },
+          ],
+      },
+  }
 ---
 
 # gifgrep
@@ -10,9 +34,11 @@ metadata: {"openclaw":{"emoji":"🧲","requires":{"bins":["gifgrep"]},"install":
 Use `gifgrep` to search GIF providers (Tenor/Giphy), browse in a TUI, download results, and extract stills or sheets.
 
 GIF-Grab (gifgrep workflow)
+
 - Search → preview → download → extract (still/sheet) for fast review and sharing.
 
 Quick start
+
 - `gifgrep cats --max 5`
 - `gifgrep cats --format url | head -n 5`
 - `gifgrep search --json cats | jq '.[0].url'`
@@ -20,28 +46,34 @@ Quick start
 - `gifgrep cats --download --max 1 --format url`
 
 TUI + previews
+
 - TUI: `gifgrep tui "query"`
 - CLI still previews: `--thumbs` (Kitty/Ghostty only; still frame)
 
 Download + reveal
+
 - `--download` saves to `~/Downloads`
 - `--reveal` shows the last download in Finder
 
 Stills + sheets
+
 - `gifgrep still ./clip.gif --at 1.5s -o still.png`
 - `gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png`
 - Sheets = single PNG grid of sampled frames (great for quick review, docs, PRs, chat).
 - Tune: `--frames` (count), `--cols` (grid width), `--padding` (spacing).
 
 Providers
+
 - `--source auto|tenor|giphy`
 - `GIPHY_API_KEY` required for `--source giphy`
 - `TENOR_API_KEY` optional (Tenor demo key used if unset)
 
 Output
+
 - `--json` prints an array of results (`id`, `title`, `url`, `preview_url`, `tags`, `width`, `height`)
 - `--format` for pipe-friendly fields (e.g., `url`)
 
 Environment tweaks
+
 - `GIFGREP_SOFTWARE_ANIM=1` to force software animation
 - `GIFGREP_CELL_ASPECT=0.5` to tweak preview geometry

skills/github/SKILL.md

@@ -1,7 +1,31 @@
 ---
 name: github
 description: "Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries."
-metadata: {"openclaw":{"emoji":"🐙","requires":{"bins":["gh"]},"install":[{"id":"brew","kind":"brew","formula":"gh","bins":["gh"],"label":"Install GitHub CLI (brew)"},{"id":"apt","kind":"apt","package":"gh","bins":["gh"],"label":"Install GitHub CLI (apt)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🐙",
+        "requires": { "bins": ["gh"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "gh",
+              "bins": ["gh"],
+              "label": "Install GitHub CLI (brew)",
+            },
+            {
+              "id": "apt",
+              "kind": "apt",
+              "package": "gh",
+              "bins": ["gh"],
+              "label": "Install GitHub CLI (apt)",
+            },
+          ],
+      },
+  }
 ---
 
 # GitHub Skill
@@ -11,21 +35,25 @@ Use the `gh` CLI to interact with GitHub. Always specify `--repo owner/repo` whe
 ## Pull Requests
 
 Check CI status on a PR:
+
 ```bash
 gh pr checks 55 --repo owner/repo
 ```
 
 List recent workflow runs:
+
 ```bash
 gh run list --repo owner/repo --limit 10
 ```
 
 View a run and see which steps failed:
+
 ```bash
 gh run view <run-id> --repo owner/repo
 ```
 
 View logs for failed steps only:
+
 ```bash
 gh run view <run-id> --repo owner/repo --log-failed
 ```
@@ -35,13 +63,14 @@ gh run view <run-id> --repo owner/repo --log-failed
 The `gh api` command is useful for accessing data not available through other subcommands.
 
 Get PR with specific fields:
+
 ```bash
 gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
 ```
 
 ## JSON Output
 
-Most commands support `--json` for structured output.  You can use `--jq` to filter:
+Most commands support `--json` for structured output. You can use `--jq` to filter:
 
 ```bash
 gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'

skills/gog/SKILL.md

@@ -2,7 +2,24 @@
 name: gog
 description: Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
 homepage: https://gogcli.sh
-metadata: {"openclaw":{"emoji":"🎮","requires":{"bins":["gog"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/gogcli","bins":["gog"],"label":"Install gog (brew)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🎮",
+        "requires": { "bins": ["gog"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/gogcli",
+              "bins": ["gog"],
+              "label": "Install gog (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # gog
@@ -10,11 +27,13 @@ metadata: {"openclaw":{"emoji":"🎮","requires":{"bins":["gog"]},"install":[{"i
 Use `gog` for Gmail/Calendar/Drive/Contacts/Sheets/Docs. Requires OAuth setup.
 
 Setup (once)
+
 - `gog auth credentials /path/to/client_secret.json`
 - `gog auth add you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets`
 - `gog auth list`
 
 Common commands
+
 - Gmail search: `gog gmail search 'newer_than:7d' --max 10`
 - Gmail messages search (per email, ignores threading): `gog gmail messages search "in:inbox from:ryanair.com" --max 20 --account you@example.com`
 - Gmail send (plain): `gog gmail send --to a@b.com --subject "Hi" --body "Hello"`
@@ -40,6 +59,7 @@ Common commands
 - Docs cat: `gog docs cat <docId>`
 
 Calendar Colors
+
 - Use `gog calendar colors` to see all available event colors (IDs 1-11)
 - Add colors to events with `--event-color <id>` flag
 - Event color IDs (from `gog calendar colors` output):
@@ -56,12 +76,14 @@ Calendar Colors
   - 11: #dc2127
 
 Email Formatting
+
 - Prefer plain text. Use `--body-file` for multi-paragraph messages (or `--body-file -` for stdin).
 - Same `--body-file` pattern works for drafts and replies.
 - `--body` does not unescape `\n`. If you need inline newlines, use a heredoc or `$'Line 1\n\nLine 2'`.
 - Use `--body-html` only when you need rich formatting.
 - HTML tags: `<p>` for paragraphs, `<br>` for line breaks, `<strong>` for bold, `<em>` for italic, `<a href="url">` for links, `<ul>`/`<li>` for lists.
 - Example (plain text via stdin):
+
   ```bash
   gog gmail send --to recipient@example.com \
     --subject "Meeting Follow-up" \
@@ -76,6 +98,7 @@ Email Formatting
   Your Name
   EOF
   ```
+
 - Example (HTML list):
   ```bash
   gog gmail send --to recipient@example.com \
@@ -84,6 +107,7 @@ Email Formatting
   ```
 
 Notes
+
 - Set `GOG_ACCOUNT=you@gmail.com` to avoid repeating `--account`.
 - For scripting, prefer `--json` plus `--no-input`.
 - Sheets values can be passed via `--values-json` (recommended) or as inline rows.

skills/goplaces/SKILL.md

@@ -2,7 +2,25 @@
 name: goplaces
 description: Query Google Places API (New) via the goplaces CLI for text search, place details, resolve, and reviews. Use for human-friendly place lookup or JSON output for scripts.
 homepage: https://github.com/steipete/goplaces
-metadata: {"openclaw":{"emoji":"📍","requires":{"bins":["goplaces"],"env":["GOOGLE_PLACES_API_KEY"]},"primaryEnv":"GOOGLE_PLACES_API_KEY","install":[{"id":"brew","kind":"brew","formula":"steipete/tap/goplaces","bins":["goplaces"],"label":"Install goplaces (brew)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📍",
+        "requires": { "bins": ["goplaces"], "env": ["GOOGLE_PLACES_API_KEY"] },
+        "primaryEnv": "GOOGLE_PLACES_API_KEY",
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/goplaces",
+              "bins": ["goplaces"],
+              "label": "Install goplaces (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # goplaces
@@ -10,13 +28,16 @@ metadata: {"openclaw":{"emoji":"📍","requires":{"bins":["goplaces"],"env":["GO
 Modern Google Places API (New) CLI. Human output by default, `--json` for scripts.
 
 Install
+
 - Homebrew: `brew install steipete/tap/goplaces`
 
 Config
+
 - `GOOGLE_PLACES_API_KEY` required.
 - Optional: `GOOGLE_PLACES_BASE_URL` for testing/proxying.
 
 Common commands
+
 - Search: `goplaces search "coffee" --open-now --min-rating 4 --limit 5`
 - Bias: `goplaces search "pizza" --lat 40.8 --lng -73.9 --radius-m 3000`
 - Pagination: `goplaces search "pizza" --page-token "NEXT_PAGE_TOKEN"`
@@ -25,6 +46,7 @@ Common commands
 - JSON: `goplaces search "sushi" --json`
 
 Notes
+
 - `--no-color` or `NO_COLOR` disables ANSI color.
 - Price levels: 0..4 (free → very expensive).
 - Type filter sends only the first `--type` value (API accepts one).

skills/himalaya/SKILL.md

@@ -2,7 +2,24 @@
 name: himalaya
 description: "CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language)."
 homepage: https://github.com/pimalaya/himalaya
-metadata: {"openclaw":{"emoji":"📧","requires":{"bins":["himalaya"]},"install":[{"id":"brew","kind":"brew","formula":"himalaya","bins":["himalaya"],"label":"Install Himalaya (brew)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📧",
+        "requires": { "bins": ["himalaya"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "himalaya",
+              "bins": ["himalaya"],
+              "label": "Install Himalaya (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # Himalaya Email CLI
@@ -23,11 +40,13 @@ Himalaya is a CLI email client that lets you manage emails from the terminal usi
 ## Configuration Setup
 
 Run the interactive wizard to set up an account:
+
 ```bash
 himalaya account configure
 ```
 
 Or create `~/.config/himalaya/config.toml` manually:
+
 ```toml
 [accounts.personal]
 email = "you@example.com"
@@ -62,16 +81,19 @@ himalaya folder list
 ### List Emails
 
 List emails in INBOX (default):
+
 ```bash
 himalaya envelope list
 ```
 
 List emails in a specific folder:
+
 ```bash
 himalaya envelope list --folder "Sent"
 ```
 
 List with pagination:
+
 ```bash
 himalaya envelope list --page 1 --page-size 20
 ```
@@ -85,11 +107,13 @@ himalaya envelope list from john@example.com subject meeting
 ### Read an Email
 
 Read email by ID (shows plain text):
+
 ```bash
 himalaya message read 42
 ```
 
 Export raw MIME:
+
 ```bash
 himalaya message export 42 --full
 ```
@@ -97,11 +121,13 @@ himalaya message export 42 --full
 ### Reply to an Email
 
 Interactive reply (opens $EDITOR):
+
 ```bash
 himalaya message reply 42
 ```
 
 Reply-all:
+
 ```bash
 himalaya message reply 42 --all
 ```
@@ -115,11 +141,13 @@ himalaya message forward 42
 ### Write a New Email
 
 Interactive compose (opens $EDITOR):
+
 ```bash
 himalaya message write
 ```
 
 Send directly using template:
+
 ```bash
 cat << 'EOF' | himalaya template send
 From: you@example.com
@@ -131,6 +159,7 @@ EOF
 ```
 
 Or with headers flag:
+
 ```bash
 himalaya message write -H "To:recipient@example.com" -H "Subject:Test" "Message body here"
 ```
@@ -138,11 +167,13 @@ himalaya message write -H "To:recipient@example.com" -H "Subject:Test" "Message
 ### Move/Copy Emails
 
 Move to folder:
+
 ```bash
 himalaya message move 42 "Archive"
 ```
 
 Copy to folder:
+
 ```bash
 himalaya message copy 42 "Important"
 ```
@@ -156,11 +187,13 @@ himalaya message delete 42
 ### Manage Flags
 
 Add flag:
+
 ```bash
 himalaya flag add 42 --flag seen
 ```
 
 Remove flag:
+
 ```bash
 himalaya flag remove 42 --flag seen
 ```
@@ -168,11 +201,13 @@ himalaya flag remove 42 --flag seen
 ## Multiple Accounts
 
 List accounts:
+
 ```bash
 himalaya account list
 ```
 
 Use a specific account:
+
 ```bash
 himalaya --account work envelope list
 ```
@@ -180,11 +215,13 @@ himalaya --account work envelope list
 ## Attachments
 
 Save attachments from a message:
+
 ```bash
 himalaya attachment download 42
 ```
 
 Save to specific directory:
+
 ```bash
 himalaya attachment download 42 --dir ~/Downloads
 ```
@@ -192,6 +229,7 @@ himalaya attachment download 42 --dir ~/Downloads
 ## Output Formats
 
 Most commands support `--output` for structured output:
+
 ```bash
 himalaya envelope list --output json
 himalaya envelope list --output plain
@@ -200,11 +238,13 @@ himalaya envelope list --output plain
 ## Debugging
 
 Enable debug logging:
+
 ```bash
 RUST_LOG=debug himalaya envelope list
 ```
 
 Full trace with backtrace:
+
 ```bash
 RUST_LOG=trace RUST_BACKTRACE=1 himalaya envelope list
 ```

skills/himalaya/references/configuration.md

@@ -32,20 +32,24 @@ message.send.backend.auth.raw = "your-password"
 ## Password Options
 
 ### Raw password (testing only, not recommended)
+
 ```toml
 backend.auth.raw = "your-password"
 ```
 
 ### Password from command (recommended)
+
 ```toml
 backend.auth.cmd = "pass show email/imap"
 # backend.auth.cmd = "security find-generic-password -a user@example.com -s imap -w"
 ```
 
 ### System keyring (requires keyring feature)
+
 ```toml
 backend.auth.keyring = "imap-example"
 ```
+
 Then run `himalaya account configure <account>` to store the password.
 
 ## Gmail Configuration
@@ -104,6 +108,7 @@ message.send.backend.auth.cmd = "pass show icloud/app-password"
 ## Folder Aliases
 
 Map custom folder names:
+
 ```toml
 [accounts.default.folder.alias]
 inbox = "INBOX"
@@ -126,6 +131,7 @@ email = "work@company.com"
 ```
 
 Switch accounts with `--account`:
+
 ```bash
 himalaya --account work envelope list
 ```
@@ -155,6 +161,7 @@ backend.auth.token-url = "https://provider.com/oauth/token"
 ## Additional Options
 
 ### Signature
+
 ```toml
 [accounts.default]
 signature = "Best regards,\nYour Name"
@@ -162,13 +169,16 @@ signature-delim = "-- \n"
 ```
 
 ### Downloads directory
+
 ```toml
 [accounts.default]
 downloads-dir = "~/Downloads/himalaya"
 ```
 
 ### Editor for composing
+
 Set via environment variable:
+
 ```bash
 export EDITOR="vim"
 ```

skills/himalaya/references/message-composition.md

@@ -17,6 +17,7 @@ This is the message body.
 ## Headers
 
 Common headers:
+
 - `From`: Sender address
 - `To`: Primary recipient(s)
 - `Cc`: Carbon copy recipients
@@ -37,6 +38,7 @@ To: user1@example.com, user2@example.com, "Jane" <jane@example.com>
 ## Plain Text Body
 
 Simple plain text email:
+
 ```
 From: alice@localhost
 To: bob@localhost
@@ -54,6 +56,7 @@ Alice
 ### Multipart Messages
 
 Alternative text/html parts:
+
 ```
 From: alice@localhost
 To: bob@localhost
@@ -69,6 +72,7 @@ This is the plain text version.
 ### Attachments
 
 Attach a file:
+
 ```
 From: alice@localhost
 To: bob@localhost
@@ -80,11 +84,13 @@ Here is the document you requested.
 ```
 
 Attachment with custom name:
+
 ```
 <#part filename=/path/to/file.pdf name=report.pdf><#/part>
 ```
 
 Multiple attachments:
+
 ```
 <#part filename=/path/to/doc1.pdf><#/part>
 <#part filename=/path/to/doc2.pdf><#/part>
@@ -93,6 +99,7 @@ Multiple attachments:
 ### Inline Images
 
 Embed an image inline:
+
 ```
 From: alice@localhost
 To: bob@localhost
@@ -129,13 +136,17 @@ Alice
 ## MML Tag Reference
 
 ### `<#multipart>`
+
 Groups multiple parts together.
+
 - `type=alternative`: Different representations of same content
 - `type=mixed`: Independent parts (text + attachments)
 - `type=related`: Parts that reference each other (HTML + images)
 
 ### `<#part>`
+
 Defines a message part.
+
 - `type=<mime-type>`: Content type (e.g., `text/html`, `application/pdf`)
 - `filename=<path>`: File to attach
 - `name=<name>`: Display name for attachment
@@ -145,28 +156,34 @@ Defines a message part.
 ## Composing from CLI
 
 ### Interactive compose
+
 Opens your `$EDITOR`:
+
 ```bash
 himalaya message write
 ```
 
 ### Reply (opens editor with quoted message)
+
 ```bash
 himalaya message reply 42
 himalaya message reply 42 --all  # reply-all
 ```
 
 ### Forward
+
 ```bash
 himalaya message forward 42
 ```
 
 ### Send from stdin
+
 ```bash
 cat message.txt | himalaya template send
 ```
 
 ### Prefill headers from CLI
+
 ```bash
 himalaya message write \
   -H "To:recipient@example.com" \

skills/imsg/SKILL.md

@@ -2,7 +2,25 @@
 name: imsg
 description: iMessage/SMS CLI for listing chats, history, watch, and sending.
 homepage: https://imsg.to
-metadata: {"openclaw":{"emoji":"📨","os":["darwin"],"requires":{"bins":["imsg"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/imsg","bins":["imsg"],"label":"Install imsg (brew)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📨",
+        "os": ["darwin"],
+        "requires": { "bins": ["imsg"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/imsg",
+              "bins": ["imsg"],
+              "label": "Install imsg (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # imsg
@@ -10,16 +28,19 @@ metadata: {"openclaw":{"emoji":"📨","os":["darwin"],"requires":{"bins":["imsg"
 Use `imsg` to read and send Messages.app iMessage/SMS on macOS.
 
 Requirements
+
 - Messages.app signed in
 - Full Disk Access for your terminal
 - Automation permission to control Messages.app (for sending)
 
 Common commands
+
 - List chats: `imsg chats --limit 10 --json`
 - History: `imsg history --chat-id 1 --limit 20 --attachments --json`
 - Watch: `imsg watch --chat-id 1 --attachments`
 - Send: `imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg`
 
 Notes
+
 - `--service imessage|sms|auto` controls delivery.
 - Confirm recipient + message before sending.

skills/local-places/SKILL.md

@@ -2,12 +2,20 @@
 name: local-places
 description: Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
 homepage: https://github.com/Hyaxia/local_places
-metadata: {"openclaw":{"emoji":"📍","requires":{"bins":["uv"],"env":["GOOGLE_PLACES_API_KEY"]},"primaryEnv":"GOOGLE_PLACES_API_KEY"}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📍",
+        "requires": { "bins": ["uv"], "env": ["GOOGLE_PLACES_API_KEY"] },
+        "primaryEnv": "GOOGLE_PLACES_API_KEY",
+      },
+  }
 ---
 
 # 📍 Local Places
 
-*Find places, Go fast*
+_Find places, Go fast_
 
 Search for nearby places using a local Google Places API proxy. Two-step flow: resolve location first, then search.
 
@@ -27,6 +35,7 @@ Requires `GOOGLE_PLACES_API_KEY` in `.env` or environment.
 1. **Check server:** `curl http://127.0.0.1:8000/ping`
 
 2. **Resolve location:**
+
 ```bash
 curl -X POST http://127.0.0.1:8000/locations/resolve \
   -H "Content-Type: application/json" \
@@ -34,6 +43,7 @@ curl -X POST http://127.0.0.1:8000/locations/resolve \
 ```
 
 3. **Search places:**
+
 ```bash
 curl -X POST http://127.0.0.1:8000/places/search \
   -H "Content-Type: application/json" \
@@ -46,6 +56,7 @@ curl -X POST http://127.0.0.1:8000/places/search \
 ```
 
 4. **Get details:**
+
 ```bash
 curl http://127.0.0.1:8000/places/{place_id}
 ```
@@ -77,7 +88,7 @@ curl http://127.0.0.1:8000/places/{place_id}
       "place_id": "ChIJ...",
       "name": "Coffee Shop",
       "address": "123 Main St",
-      "location": {"lat": 51.5, "lng": -0.1},
+      "location": { "lat": 51.5, "lng": -0.1 },
       "rating": 4.6,
       "price_level": 2,
       "types": ["cafe", "food"],

skills/local-places/pyproject.toml

@@ -4,16 +4,10 @@ version = "0.1.0"
 description = "FastAPI server"
 readme = "README.md"
 requires-python = ">=3.11"
-dependencies = [
-  "fastapi>=0.110.0",
-  "httpx>=0.27.0",
-  "uvicorn[standard]>=0.29.0",
-]
+dependencies = ["fastapi>=0.110.0", "httpx>=0.27.0", "uvicorn[standard]>=0.29.0"]
 
 [project.optional-dependencies]
-dev = [
-  "pytest>=8.0.0",
-]
+dev = ["pytest>=8.0.0"]
 
 [build-system]
 requires = ["hatchling"]

skills/mcporter/SKILL.md

@@ -2,7 +2,24 @@
 name: mcporter
 description: Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.
 homepage: http://mcporter.dev
-metadata: {"openclaw":{"emoji":"📦","requires":{"bins":["mcporter"]},"install":[{"id":"node","kind":"node","package":"mcporter","bins":["mcporter"],"label":"Install mcporter (node)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📦",
+        "requires": { "bins": ["mcporter"] },
+        "install":
+          [
+            {
+              "id": "node",
+              "kind": "node",
+              "package": "mcporter",
+              "bins": ["mcporter"],
+              "label": "Install mcporter (node)",
+            },
+          ],
+      },
+  }
 ---
 
 # mcporter
@@ -10,11 +27,13 @@ metadata: {"openclaw":{"emoji":"📦","requires":{"bins":["mcporter"]},"install"
 Use `mcporter` to work with MCP servers directly.
 
 Quick start
+
 - `mcporter list`
 - `mcporter list <server> --schema`
 - `mcporter call <server.tool> key=value`
 
 Call tools
+
 - Selector: `mcporter call linear.list_issues team=ENG limit:5`
 - Function syntax: `mcporter call "linear.create_issue(title: \"Bug\")"`
 - Full URL: `mcporter call https://api.example.com/mcp.fetch url:https://example.com`
@@ -22,17 +41,21 @@ Call tools
 - JSON payload: `mcporter call <server.tool> --args '{"limit":5}'`
 
 Auth + config
+
 - OAuth: `mcporter auth <server | url> [--reset]`
 - Config: `mcporter config list|get|add|remove|import|login|logout`
 
 Daemon
+
 - `mcporter daemon start|status|stop|restart`
 
 Codegen
+
 - CLI: `mcporter generate-cli --server <name>` or `--command <url>`
 - Inspect: `mcporter inspect-cli <path> [--json]`
 - TS: `mcporter emit-ts <server> --mode client|types`
 
 Notes
+
 - Config default: `./config/mcporter.json` (override with `--config`).
 - Prefer `--output json` for machine-readable results.

skills/model-usage/SKILL.md

@@ -1,19 +1,39 @@
 ---
 name: model-usage
 description: Use CodexBar CLI local cost usage to summarize per-model usage for Codex or Claude, including the current (most recent) model or a full model breakdown. Trigger when asked for model-level usage/cost data from codexbar, or when you need a scriptable per-model summary from codexbar cost JSON.
-metadata: {"openclaw":{"emoji":"📊","os":["darwin"],"requires":{"bins":["codexbar"]},"install":[{"id":"brew-cask","kind":"brew","cask":"steipete/tap/codexbar","bins":["codexbar"],"label":"Install CodexBar (brew cask)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📊",
+        "os": ["darwin"],
+        "requires": { "bins": ["codexbar"] },
+        "install":
+          [
+            {
+              "id": "brew-cask",
+              "kind": "brew",
+              "cask": "steipete/tap/codexbar",
+              "bins": ["codexbar"],
+              "label": "Install CodexBar (brew cask)",
+            },
+          ],
+      },
+  }
 ---
 
 # Model usage
 
 ## Overview
+
 Get per-model usage cost from CodexBar's local cost logs. Supports "current model" (most recent daily entry) or "all models" summaries for Codex or Claude.
 
 TODO: add Linux CLI support guidance once CodexBar CLI install path is documented for Linux.
 
 ## Quick start
-1) Fetch cost JSON via CodexBar CLI or pass a JSON file.
-2) Use the bundled script to summarize by model.
+
+1. Fetch cost JSON via CodexBar CLI or pass a JSON file.
+2. Use the bundled script to summarize by model.
 
 ```bash
 python {baseDir}/scripts/model_usage.py --provider codex --mode current
@@ -22,12 +42,14 @@ python {baseDir}/scripts/model_usage.py --provider claude --mode all --format js
 ```
 
 ## Current model logic
+
 - Uses the most recent daily row with `modelBreakdowns`.
 - Picks the model with the highest cost in that row.
 - Falls back to the last entry in `modelsUsed` when breakdowns are missing.
 - Override with `--model <name>` when you need a specific model.
 
 ## Inputs
+
 - Default: runs `codexbar cost --format json --provider <codex|claude>`.
 - File or stdin:
 
@@ -38,8 +60,10 @@ cat /tmp/cost.json | python {baseDir}/scripts/model_usage.py --input - --mode cu
 ```
 
 ## Output
+
 - Text (default) or JSON (`--format json --pretty`).
 - Values are cost-only per model; tokens are not split by model in CodexBar output.
 
 ## References
+
 - Read `references/codexbar-cli.md` for CLI flags and cost JSON fields.

skills/model-usage/references/codexbar-cli.md

@@ -1,10 +1,12 @@
 # CodexBar CLI quick ref (usage + cost)
 
 ## Install
+
 - App: Preferences -> Advanced -> Install CLI
 - Repo: ./bin/install-codexbar-cli.sh
 
 ## Commands
+
 - Usage snapshot (web/cli sources):
   - codexbar usage --format json --pretty
   - codexbar --provider all --format json
@@ -13,7 +15,9 @@
   - codexbar cost --provider codex|claude --format json
 
 ## Cost JSON fields
+
 The payload is an array (one per provider).
+
 - provider, source, updatedAt
 - sessionTokens, sessionCostUSD
 - last30DaysTokens, last30DaysCostUSD
@@ -22,7 +26,8 @@ The payload is an array (one per provider).
 - totals: totalInputTokens, totalOutputTokens, cacheReadTokens, cacheCreationTokens, totalTokens, totalCost
 
 ## Notes
+
 - Cost usage is local-only. It reads JSONL logs under:
-  - Codex: ~/.codex/sessions/**/*.jsonl
-  - Claude: ~/.config/claude/projects/**/*.jsonl or ~/.claude/projects/**/*.jsonl
+  - Codex: ~/.codex/sessions/\*_/_.jsonl
+  - Claude: ~/.config/claude/projects/**/\*.jsonl or ~/.claude/projects/**/\*.jsonl
 - If web usage is required (non-local), use codexbar usage (not cost).

skills/nano-banana-pro/SKILL.md

@@ -2,7 +2,25 @@
 name: nano-banana-pro
 description: Generate or edit images via Gemini 3 Pro Image (Nano Banana Pro).
 homepage: https://ai.google.dev/
-metadata: {"openclaw":{"emoji":"🍌","requires":{"bins":["uv"],"env":["GEMINI_API_KEY"]},"primaryEnv":"GEMINI_API_KEY","install":[{"id":"uv-brew","kind":"brew","formula":"uv","bins":["uv"],"label":"Install uv (brew)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🍌",
+        "requires": { "bins": ["uv"], "env": ["GEMINI_API_KEY"] },
+        "primaryEnv": "GEMINI_API_KEY",
+        "install":
+          [
+            {
+              "id": "uv-brew",
+              "kind": "brew",
+              "formula": "uv",
+              "bins": ["uv"],
+              "label": "Install uv (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # Nano Banana Pro (Gemini 3 Pro Image)
@@ -10,25 +28,30 @@ metadata: {"openclaw":{"emoji":"🍌","requires":{"bins":["uv"],"env":["GEMINI_A
 Use the bundled script to generate or edit images.
 
 Generate
+
 ```bash
 uv run {baseDir}/scripts/generate_image.py --prompt "your image description" --filename "output.png" --resolution 1K
 ```
 
 Edit (single image)
+
 ```bash
 uv run {baseDir}/scripts/generate_image.py --prompt "edit instructions" --filename "output.png" -i "/path/in.png" --resolution 2K
 ```
 
 Multi-image composition (up to 14 images)
+
 ```bash
 uv run {baseDir}/scripts/generate_image.py --prompt "combine these into one scene" --filename "output.png" -i img1.png -i img2.png -i img3.png
 ```
 
 API key
+
 - `GEMINI_API_KEY` env var
 - Or set `skills."nano-banana-pro".apiKey` / `skills."nano-banana-pro".env.GEMINI_API_KEY` in `~/.openclaw/openclaw.json`
 
 Notes
+
 - Resolutions: `1K` (default), `2K`, `4K`.
 - Use timestamps in filenames: `yyyy-mm-dd-hh-mm-ss-name.png`.
 - The script prints a `MEDIA:` line for OpenClaw to auto-attach on supported chat providers.

skills/nano-pdf/SKILL.md

@@ -2,7 +2,24 @@
 name: nano-pdf
 description: Edit PDFs with natural-language instructions using the nano-pdf CLI.
 homepage: https://pypi.org/project/nano-pdf/
-metadata: {"openclaw":{"emoji":"📄","requires":{"bins":["nano-pdf"]},"install":[{"id":"uv","kind":"uv","package":"nano-pdf","bins":["nano-pdf"],"label":"Install nano-pdf (uv)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📄",
+        "requires": { "bins": ["nano-pdf"] },
+        "install":
+          [
+            {
+              "id": "uv",
+              "kind": "uv",
+              "package": "nano-pdf",
+              "bins": ["nano-pdf"],
+              "label": "Install nano-pdf (uv)",
+            },
+          ],
+      },
+  }
 ---
 
 # nano-pdf
@@ -16,5 +33,6 @@ nano-pdf edit deck.pdf 1 "Change the title to 'Q3 Results' and fix the typo in t
 ```
 
 Notes:
+
 - Page numbers are 0-based or 1-based depending on the tool’s version/config; if the result looks off by one, retry with the other.
 - Always sanity-check the output PDF before sending it out.

skills/notion/SKILL.md

@@ -2,7 +2,11 @@
 name: notion
 description: Notion API for creating and managing pages, databases, and blocks.
 homepage: https://developers.notion.com
-metadata: {"openclaw":{"emoji":"📝","requires":{"env":["NOTION_API_KEY"]},"primaryEnv":"NOTION_API_KEY"}}
+metadata:
+  {
+    "openclaw":
+      { "emoji": "📝", "requires": { "env": ["NOTION_API_KEY"] }, "primaryEnv": "NOTION_API_KEY" },
+  }
 ---
 
 # notion
@@ -14,15 +18,18 @@ Use the Notion API to create/read/update pages, data sources (databases), and bl
 1. Create an integration at https://notion.so/my-integrations
 2. Copy the API key (starts with `ntn_` or `secret_`)
 3. Store it:
+
 ```bash
 mkdir -p ~/.config/notion
 echo "ntn_your_key_here" > ~/.config/notion/api_key
 ```
+
 4. Share target pages/databases with your integration (click "..." → "Connect to" → your integration name)
 
 ## API Basics
 
 All requests need:
+
 ```bash
 NOTION_KEY=$(cat ~/.config/notion/api_key)
 curl -X GET "https://api.notion.com/v1/..." \
@@ -36,6 +43,7 @@ curl -X GET "https://api.notion.com/v1/..." \
 ## Common Operations
 
 **Search for pages and data sources:**
+
 ```bash
 curl -X POST "https://api.notion.com/v1/search" \
   -H "Authorization: Bearer $NOTION_KEY" \
@@ -45,6 +53,7 @@ curl -X POST "https://api.notion.com/v1/search" \
 ```
 
 **Get page:**
+
 ```bash
 curl "https://api.notion.com/v1/pages/{page_id}" \
   -H "Authorization: Bearer $NOTION_KEY" \
@@ -52,6 +61,7 @@ curl "https://api.notion.com/v1/pages/{page_id}" \
 ```
 
 **Get page content (blocks):**
+
 ```bash
 curl "https://api.notion.com/v1/blocks/{page_id}/children" \
   -H "Authorization: Bearer $NOTION_KEY" \
@@ -59,6 +69,7 @@ curl "https://api.notion.com/v1/blocks/{page_id}/children" \
 ```
 
 **Create page in a data source:**
+
 ```bash
 curl -X POST "https://api.notion.com/v1/pages" \
   -H "Authorization: Bearer $NOTION_KEY" \
@@ -74,6 +85,7 @@ curl -X POST "https://api.notion.com/v1/pages" \
 ```
 
 **Query a data source (database):**
+
 ```bash
 curl -X POST "https://api.notion.com/v1/data_sources/{data_source_id}/query" \
   -H "Authorization: Bearer $NOTION_KEY" \
@@ -86,6 +98,7 @@ curl -X POST "https://api.notion.com/v1/data_sources/{data_source_id}/query" \
 ```
 
 **Create a data source (database):**
+
 ```bash
 curl -X POST "https://api.notion.com/v1/data_sources" \
   -H "Authorization: Bearer $NOTION_KEY" \
@@ -103,6 +116,7 @@ curl -X POST "https://api.notion.com/v1/data_sources" \
 ```
 
 **Update page properties:**
+
 ```bash
 curl -X PATCH "https://api.notion.com/v1/pages/{page_id}" \
   -H "Authorization: Bearer $NOTION_KEY" \
@@ -112,6 +126,7 @@ curl -X PATCH "https://api.notion.com/v1/pages/{page_id}" \
 ```
 
 **Add blocks to page:**
+
 ```bash
 curl -X PATCH "https://api.notion.com/v1/blocks/{page_id}/children" \
   -H "Authorization: Bearer $NOTION_KEY" \
@@ -127,6 +142,7 @@ curl -X PATCH "https://api.notion.com/v1/blocks/{page_id}/children" \
 ## Property Types
 
 Common property formats for database items:
+
 - **Title:** `{"title": [{"text": {"content": "..."}}]}`
 - **Rich text:** `{"rich_text": [{"text": {"content": "..."}}]}`
 - **Select:** `{"select": {"name": "Option"}}`

skills/obsidian/SKILL.md

@@ -2,7 +2,24 @@
 name: obsidian
 description: Work with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
 homepage: https://help.obsidian.md
-metadata: {"openclaw":{"emoji":"💎","requires":{"bins":["obsidian-cli"]},"install":[{"id":"brew","kind":"brew","formula":"yakitrak/yakitrak/obsidian-cli","bins":["obsidian-cli"],"label":"Install obsidian-cli (brew)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "💎",
+        "requires": { "bins": ["obsidian-cli"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "yakitrak/yakitrak/obsidian-cli",
+              "bins": ["obsidian-cli"],
+              "label": "Install obsidian-cli (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # Obsidian
@@ -10,6 +27,7 @@ metadata: {"openclaw":{"emoji":"💎","requires":{"bins":["obsidian-cli"]},"inst
 Obsidian vault = a normal folder on disk.
 
 Vault structure (typical)
+
 - Notes: `*.md` (plain text Markdown; edit with any editor)
 - Config: `.obsidian/` (workspace + plugin settings; usually don’t touch from scripts)
 - Canvases: `*.canvas` (JSON)
@@ -18,38 +36,46 @@ Vault structure (typical)
 ## Find the active vault(s)
 
 Obsidian desktop tracks vaults here (source of truth):
+
 - `~/Library/Application Support/obsidian/obsidian.json`
 
 `obsidian-cli` resolves vaults from that file; vault name is typically the **folder name** (path suffix).
 
 Fast “what vault is active / where are the notes?”
+
 - If you’ve already set a default: `obsidian-cli print-default --path-only`
 - Otherwise, read `~/Library/Application Support/obsidian/obsidian.json` and use the vault entry with `"open": true`.
 
 Notes
+
 - Multiple vaults common (iCloud vs `~/Documents`, work/personal, etc.). Don’t guess; read config.
 - Avoid writing hardcoded vault paths into scripts; prefer reading the config or using `print-default`.
 
 ## obsidian-cli quick start
 
 Pick a default vault (once):
+
 - `obsidian-cli set-default "<vault-folder-name>"`
 - `obsidian-cli print-default` / `obsidian-cli print-default --path-only`
 
 Search
+
 - `obsidian-cli search "query"` (note names)
 - `obsidian-cli search-content "query"` (inside notes; shows snippets + lines)
 
 Create
+
 - `obsidian-cli create "Folder/New note" --content "..." --open`
 - Requires Obsidian URI handler (`obsidian://…`) working (Obsidian installed).
 - Avoid creating notes under “hidden” dot-folders (e.g. `.something/...`) via URI; Obsidian may refuse.
 
 Move/rename (safe refactor)
+
 - `obsidian-cli move "old/path/note" "new/path/note"`
 - Updates `[[wikilinks]]` and common Markdown links across the vault (this is the main win vs `mv`).
 
 Delete
+
 - `obsidian-cli delete "path/note"`
 
 Prefer direct edits when appropriate: open the `.md` file and change it; Obsidian will pick it up.

skills/openai-image-gen/SKILL.md

@@ -2,7 +2,25 @@
 name: openai-image-gen
 description: Batch-generate images via OpenAI Images API. Random prompt sampler + `index.html` gallery.
 homepage: https://platform.openai.com/docs/api-reference/images
-metadata: {"openclaw":{"emoji":"🖼️","requires":{"bins":["python3"],"env":["OPENAI_API_KEY"]},"primaryEnv":"OPENAI_API_KEY","install":[{"id":"python-brew","kind":"brew","formula":"python","bins":["python3"],"label":"Install Python (brew)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🖼️",
+        "requires": { "bins": ["python3"], "env": ["OPENAI_API_KEY"] },
+        "primaryEnv": "OPENAI_API_KEY",
+        "install":
+          [
+            {
+              "id": "python-brew",
+              "kind": "brew",
+              "formula": "python",
+              "bins": ["python3"],
+              "label": "Install Python (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # OpenAI Image Gen

skills/openai-whisper-api/SKILL.md

@@ -2,7 +2,15 @@
 name: openai-whisper-api
 description: Transcribe audio via OpenAI Audio Transcriptions API (Whisper).
 homepage: https://platform.openai.com/docs/guides/speech-to-text
-metadata: {"openclaw":{"emoji":"☁️","requires":{"bins":["curl"],"env":["OPENAI_API_KEY"]},"primaryEnv":"OPENAI_API_KEY"}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "☁️",
+        "requires": { "bins": ["curl"], "env": ["OPENAI_API_KEY"] },
+        "primaryEnv": "OPENAI_API_KEY",
+      },
+  }
 ---
 
 # OpenAI Whisper API (curl)
@@ -16,6 +24,7 @@ Transcribe an audio file via OpenAI’s `/v1/audio/transcriptions` endpoint.
 ```
 
 Defaults:
+
 - Model: `whisper-1`
 - Output: `<input>.txt`
 
@@ -36,8 +45,8 @@ Set `OPENAI_API_KEY`, or configure it in `~/.openclaw/openclaw.json`:
 {
   skills: {
     "openai-whisper-api": {
-      apiKey: "OPENAI_KEY_HERE"
-    }
-  }
+      apiKey: "OPENAI_KEY_HERE",
+    },
+  },
 }
 ```

skills/openai-whisper/SKILL.md

@@ -2,7 +2,24 @@
 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)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🎙️",
+        "requires": { "bins": ["whisper"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "openai-whisper",
+              "bins": ["whisper"],
+              "label": "Install OpenAI Whisper (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # Whisper (CLI)
@@ -10,10 +27,12 @@ metadata: {"openclaw":{"emoji":"🎙️","requires":{"bins":["whisper"]},"instal
 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.

skills/openhue/SKILL.md

@@ -2,7 +2,24 @@
 name: openhue
 description: Control Philips Hue lights/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)"}]}}
+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
@@ -10,15 +27,18 @@ metadata: {"openclaw":{"emoji":"💡","requires":{"bins":["openhue"]},"install":
 Use `openhue` to control Hue lights and scenes via a Hue Bridge.
 
 Setup
+
 - Discover bridges: `openhue discover`
 - Guided setup: `openhue setup`
 
 Read
+
 - `openhue get light --json`
 - `openhue get room --json`
 - `openhue get scene --json`
 
 Write
+
 - Turn on: `openhue set light <id-or-name> --on`
 - Turn off: `openhue set light <id-or-name> --off`
 - Brightness: `openhue set light <id> --on --brightness 50`
@@ -26,5 +46,6 @@ Write
 - Scene: `openhue set scene <scene-id>`
 
 Notes
+
 - You may need to press the Hue Bridge button during setup.
 - Use `--room "Room Name"` when light names are ambiguous.

skills/oracle/SKILL.md

@@ -2,7 +2,24 @@
 name: oracle
 description: Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).
 homepage: https://askoracle.dev
-metadata: {"openclaw":{"emoji":"🧿","requires":{"bins":["oracle"]},"install":[{"id":"node","kind":"node","package":"@steipete/oracle","bins":["oracle"],"label":"Install oracle (node)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🧿",
+        "requires": { "bins": ["oracle"] },
+        "install":
+          [
+            {
+              "id": "node",
+              "kind": "node",
+              "package": "@steipete/oracle",
+              "bins": ["oracle"],
+              "label": "Install oracle (node)",
+            },
+          ],
+      },
+  }
 ---
 
 # oracle — best use
@@ -14,6 +31,7 @@ Oracle bundles your prompt + selected files into one “one-shot” request so a
 Default workflow here: `--engine browser` with GPT‑5.2 Pro in ChatGPT. This is the common “long think” path: ~10 minutes to ~1 hour is normal; expect a stored session you can reattach to.
 
 Recommended defaults:
+
 - Engine: browser (`--engine browser`)
 - Model: GPT‑5.2 Pro (`--model gpt-5.2-pro` or `--model "5.2 Pro"`)
 
@@ -85,6 +103,7 @@ Recommended defaults:
 ## Prompt template (high signal)
 
 Oracle starts with **zero** project knowledge. Assume the model cannot infer your stack, build tooling, conventions, or “obvious” paths. Include:
+
 - Project briefing (stack + build/test commands + platform constraints).
 - “Where things live” (key directories, entrypoints, config files, boundaries).
 - Exact question + what you tried + the error text (verbatim).
@@ -98,6 +117,7 @@ Oracle starts with **zero** project knowledge. Assume the model cannot infer you
 ## “Exhaustive prompt” restoration pattern
 
 For long investigations, write a standalone prompt + file set so you can rerun days later:
+
 - 6–30 sentence project briefing + the goal.
 - Repro steps + exact errors + what you tried.
 - Attach all context files needed (entrypoints, configs, key modules, docs).

skills/ordercli/SKILL.md

@@ -2,7 +2,31 @@
 name: ordercli
 description: Foodora-only CLI for checking past orders and active order status (Deliveroo WIP).
 homepage: https://ordercli.sh
-metadata: {"openclaw":{"emoji":"🛵","requires":{"bins":["ordercli"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/ordercli","bins":["ordercli"],"label":"Install ordercli (brew)"},{"id":"go","kind":"go","module":"github.com/steipete/ordercli/cmd/ordercli@latest","bins":["ordercli"],"label":"Install ordercli (go)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🛵",
+        "requires": { "bins": ["ordercli"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/ordercli",
+              "bins": ["ordercli"],
+              "label": "Install ordercli (brew)",
+            },
+            {
+              "id": "go",
+              "kind": "go",
+              "module": "github.com/steipete/ordercli/cmd/ordercli@latest",
+              "bins": ["ordercli"],
+              "label": "Install ordercli (go)",
+            },
+          ],
+      },
+  }
 ---
 
 # ordercli
@@ -10,6 +34,7 @@ metadata: {"openclaw":{"emoji":"🛵","requires":{"bins":["ordercli"]},"install"
 Use `ordercli` to check past orders and track active order status (Foodora only right now).
 
 Quick start (Foodora)
+
 - `ordercli foodora countries`
 - `ordercli foodora config set --country AT`
 - `ordercli foodora login --email you@example.com --password-stdin`
@@ -18,30 +43,36 @@ Quick start (Foodora)
 - `ordercli foodora history show <orderCode>`
 
 Orders
+
 - Active list (arrival/status): `ordercli foodora orders`
 - Watch: `ordercli foodora orders --watch`
 - Active order detail: `ordercli foodora order <orderCode>`
 - History detail JSON: `ordercli foodora history show <orderCode> --json`
 
 Reorder (adds to cart)
+
 - Preview: `ordercli foodora reorder <orderCode>`
 - Confirm: `ordercli foodora reorder <orderCode> --confirm`
 - Address: `ordercli foodora reorder <orderCode> --confirm --address-id <id>`
 
 Cloudflare / bot protection
+
 - Browser login: `ordercli foodora login --email you@example.com --password-stdin --browser`
 - Reuse profile: `--browser-profile "$HOME/Library/Application Support/ordercli/browser-profile"`
 - Import Chrome cookies: `ordercli foodora cookies chrome --profile "Default"`
 
 Session import (no password)
+
 - `ordercli foodora session chrome --url https://www.foodora.at/ --profile "Default"`
 - `ordercli foodora session refresh --client-id android`
 
 Deliveroo (WIP, not working yet)
+
 - Requires `DELIVEROO_BEARER_TOKEN` (optional `DELIVEROO_COOKIE`).
 - `ordercli deliveroo config set --market uk`
 - `ordercli deliveroo history`
 
 Notes
+
 - Use `--config /tmp/ordercli.json` for testing.
 - Confirm before any reorder or cart-changing action.

skills/peekaboo/SKILL.md

@@ -2,7 +2,25 @@
 name: peekaboo
 description: Capture and automate macOS UI with the Peekaboo CLI.
 homepage: https://peekaboo.boo
-metadata: {"openclaw":{"emoji":"👀","os":["darwin"],"requires":{"bins":["peekaboo"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/peekaboo","bins":["peekaboo"],"label":"Install Peekaboo (brew)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "👀",
+        "os": ["darwin"],
+        "requires": { "bins": ["peekaboo"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/peekaboo",
+              "bins": ["peekaboo"],
+              "label": "Install Peekaboo (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # Peekaboo
@@ -16,6 +34,7 @@ Tip: run via `polter peekaboo` to ensure fresh builds.
 ## Features (all CLI capabilities, excluding agent/MCP)
 
 Core
+
 - `bridge`: inspect Peekaboo Bridge host connectivity
 - `capture`: live capture or video ingest + frame extraction
 - `clean`: prune snapshot cache and temp files
@@ -29,6 +48,7 @@ Core
 - `tools`: list available tools with filtering/display options
 
 Interaction
+
 - `click`: target by ID/query/coords with smart waits
 - `drag`: drag & drop across elements/coords/Dock
 - `hotkey`: modifier combos like `cmd,shift,t`
@@ -40,6 +60,7 @@ Interaction
 - `type`: text + control keys (`--clear`, delays)
 
 System
+
 - `app`: launch/quit/relaunch/hide/unhide/switch/list apps
 - `clipboard`: read/write clipboard (text/images/files)
 - `dialog`: click/input/file/dismiss/list system dialogs
@@ -52,13 +73,16 @@ System
 - `window`: close/minimize/maximize/move/resize/focus/list
 
 Vision
+
 - `see`: annotated UI maps, snapshot IDs, optional analysis
 
 Global runtime flags
+
 - `--json`/`-j`, `--verbose`/`-v`, `--log-level <level>`
 - `--no-remote`, `--bridge-socket <path>`
 
 ## Quickstart (happy path)
+
 ```bash
 peekaboo permissions
 peekaboo list apps --json
@@ -68,6 +92,7 @@ peekaboo type "Hello" --return
 ```
 
 ## Common targeting parameters (most interaction commands)
+
 - App/window: `--app`, `--pid`, `--window-title`, `--window-id`, `--window-index`
 - Snapshot targeting: `--snapshot` (ID from `see`; defaults to latest)
 - Element/coords: `--on`/`--id` (element ID), `--coords x,y`
@@ -75,6 +100,7 @@ peekaboo type "Hello" --return
   `--focus-timeout-seconds`, `--focus-retry-count`
 
 ## Common capture parameters
+
 - Output: `--path`, `--format png|jpg`, `--retina`
 - Targeting: `--mode screen|window|frontmost`, `--screen-index`,
   `--window-title`, `--window-id`
@@ -82,12 +108,15 @@ peekaboo type "Hello" --return
 - Capture engine: `--capture-engine auto|classic|cg|modern|sckit`
 
 ## Common motion/typing parameters
+
 - Timing: `--duration` (drag/swipe), `--steps`, `--delay` (type/scroll/press)
 - Human-ish movement: `--profile human|linear`, `--wpm` (typing)
 - Scroll: `--direction up|down|left|right`, `--amount <ticks>`, `--smooth`
 
 ## Examples
+
 ### See -> click -> type (most reliable flow)
+
 ```bash
 peekaboo see --app Safari --window-title "Login" --annotate --path /tmp/see.png
 peekaboo click --on B3 --app Safari
@@ -97,6 +126,7 @@ peekaboo type "supersecret" --app Safari --return
 ```
 
 ### Target by window id
+
 ```bash
 peekaboo list windows --app "Visual Studio Code" --json
 peekaboo click --window-id 12345 --coords 120,160
@@ -104,6 +134,7 @@ peekaboo type "Hello from Peekaboo" --window-id 12345
 ```
 
 ### Capture screenshots + analyze
+
 ```bash
 peekaboo image --mode screen --screen-index 0 --retina --path /tmp/screen.png
 peekaboo image --app Safari --window-title "Dashboard" --analyze "Summarize KPIs"
@@ -111,12 +142,14 @@ peekaboo see --mode screen --screen-index 0 --analyze "Summarize the dashboard"
 ```
 
 ### Live capture (motion-aware)
+
 ```bash
 peekaboo capture live --mode region --region 100,100,800,600 --duration 30 \
   --active-fps 8 --idle-fps 2 --highlight-changes --path /tmp/capture
 ```
 
 ### App + window management
+
 ```bash
 peekaboo app launch "Safari" --open https://example.com
 peekaboo window focus --app Safari --window-title "Example"
@@ -125,6 +158,7 @@ peekaboo app quit --app Safari
 ```
 
 ### Menus, menubar, dock
+
 ```bash
 peekaboo menu click --app Safari --item "New Window"
 peekaboo menu click --app TextEdit --path "Format > Font > Show Fonts"
@@ -134,6 +168,7 @@ peekaboo menubar list --json
 ```
 
 ### Mouse + gesture input
+
 ```bash
 peekaboo move 500,300 --smooth
 peekaboo drag --from B1 --to T2
@@ -142,6 +177,7 @@ peekaboo scroll --direction down --amount 6 --smooth
 ```
 
 ### Keyboard input
+
 ```bash
 peekaboo hotkey --keys "cmd,shift,t"
 peekaboo press escape
@@ -149,5 +185,6 @@ peekaboo type "Line 1\nLine 2" --delay 10
 ```
 
 Notes
+
 - Requires Screen Recording + Accessibility permissions.
 - Use `peekaboo see --annotate` to identify targets before clicking.

skills/sag/SKILL.md

@@ -2,7 +2,25 @@
 name: sag
 description: ElevenLabs text-to-speech with mac-style say UX.
 homepage: https://sag.sh
-metadata: {"openclaw":{"emoji":"🗣️","requires":{"bins":["sag"],"env":["ELEVENLABS_API_KEY"]},"primaryEnv":"ELEVENLABS_API_KEY","install":[{"id":"brew","kind":"brew","formula":"steipete/tap/sag","bins":["sag"],"label":"Install sag (brew)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🗣️",
+        "requires": { "bins": ["sag"], "env": ["ELEVENLABS_API_KEY"] },
+        "primaryEnv": "ELEVENLABS_API_KEY",
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/sag",
+              "bins": ["sag"],
+              "label": "Install sag (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # sag
@@ -10,21 +28,25 @@ metadata: {"openclaw":{"emoji":"🗣️","requires":{"bins":["sag"],"env":["ELEV
 Use `sag` for ElevenLabs TTS with local playback.
 
 API key (required)
+
 - `ELEVENLABS_API_KEY` (preferred)
 - `SAG_API_KEY` also supported by the CLI
 
 Quick start
+
 - `sag "Hello there"`
 - `sag speak -v "Roger" "Hello"`
 - `sag voices`
 - `sag prompting` (model-specific tips)
 
 Model notes
+
 - Default: `eleven_v3` (expressive)
 - Stable: `eleven_multilingual_v2`
 - Fast: `eleven_flash_v2_5`
 
 Pronunciation + delivery rules
+
 - First fix: respell (e.g. "key-note"), add hyphens, adjust casing.
 - Numbers/units/URLs: `--normalize auto` (or `off` if it harms names).
 - Language bias: `--lang en|de|fr|...` to guide normalization.
@@ -32,12 +54,14 @@ Pronunciation + delivery rules
 - v2/v2.5: SSML `<break time="1.5s" />` supported; `<phoneme>` not exposed in `sag`.
 
 v3 audio tags (put at the entrance of a line)
+
 - `[whispers]`, `[shouts]`, `[sings]`
 - `[laughs]`, `[starts laughing]`, `[sighs]`, `[exhales]`
 - `[sarcastic]`, `[curious]`, `[excited]`, `[crying]`, `[mischievously]`
 - Example: `sag "[whispers] keep this quiet. [short pause] ok?"`
 
 Voice defaults
+
 - `ELEVENLABS_VOICE_ID` or `SAG_VOICE_ID`
 
 Confirm voice + speaker before long output.
@@ -55,6 +79,7 @@ sag -v Clawd -o /tmp/voice-reply.mp3 "Your message here"
 ```
 
 Voice character tips:
+
 - Crazy scientist: Use `[excited]` tags, dramatic pauses `[short pause]`, vary intensity
 - Calm: Use `[whispers]` or slower pacing
 - Dramatic: Use `[sings]` or `[shouts]` sparingly

skills/session-logs/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: session-logs
 description: Search and analyze your own session logs (older/parent conversations) using jq.
-metadata: {"openclaw":{"emoji":"📜","requires":{"bins":["jq","rg"]}}}
+metadata: { "openclaw": { "emoji": "📜", "requires": { "bins": ["jq", "rg"] } } }
 ---
 
 # session-logs
@@ -22,6 +22,7 @@ Session logs live at: `~/.openclaw/agents/<agentId>/sessions/` (use the `agent=<
 ## Structure
 
 Each `.jsonl` file contains messages with:
+
 - `type`: "session" (metadata) or "message"
 - `timestamp`: ISO timestamp
 - `message.role`: "user", "assistant", or "toolResult"
@@ -31,6 +32,7 @@ Each `.jsonl` file contains messages with:
 ## Common Queries
 
 ### List all sessions by date and size
+
 ```bash
 for f in ~/.openclaw/agents/<agentId>/sessions/*.jsonl; do
   date=$(head -1 "$f" | jq -r '.timestamp' | cut -dT -f1)
@@ -40,6 +42,7 @@ done | sort -r
 ```
 
 ### Find sessions from a specific day
+
 ```bash
 for f in ~/.openclaw/agents/<agentId>/sessions/*.jsonl; do
   head -1 "$f" | jq -r '.timestamp' | grep -q "2026-01-06" && echo "$f"
@@ -47,21 +50,25 @@ done
 ```
 
 ### Extract user messages from a session
+
 ```bash
 jq -r 'select(.message.role == "user") | .message.content[]? | select(.type == "text") | .text' <session>.jsonl
 ```
 
 ### Search for keyword in assistant responses
+
 ```bash
 jq -r 'select(.message.role == "assistant") | .message.content[]? | select(.type == "text") | .text' <session>.jsonl | rg -i "keyword"
 ```
 
 ### Get total cost for a session
+
 ```bash
 jq -s '[.[] | .message.usage.cost.total // 0] | add' <session>.jsonl
 ```
 
 ### Daily cost summary
+
 ```bash
 for f in ~/.openclaw/agents/<agentId>/sessions/*.jsonl; do
   date=$(head -1 "$f" | jq -r '.timestamp' | cut -dT -f1)
@@ -71,6 +78,7 @@ done | awk '{a[$1]+=$2} END {for(d in a) print d, "$"a[d]}' | sort -r
 ```
 
 ### Count messages and tokens in a session
+
 ```bash
 jq -s '{
   messages: length,
@@ -82,11 +90,13 @@ jq -s '{
 ```
 
 ### Tool usage breakdown
+
 ```bash
 jq -r '.message.content[]? | select(.type == "toolCall") | .name' <session>.jsonl | sort | uniq -c | sort -rn
 ```
 
 ### Search across ALL sessions for a phrase
+
 ```bash
 rg -l "phrase" ~/.openclaw/agents/<agentId>/sessions/*.jsonl
 ```

skills/sherpa-onnx-tts/SKILL.md

@@ -1,7 +1,60 @@
 ---
 name: sherpa-onnx-tts
 description: Local text-to-speech via sherpa-onnx (offline, no cloud)
-metadata: {"openclaw":{"emoji":"🗣️","os":["darwin","linux","win32"],"requires":{"env":["SHERPA_ONNX_RUNTIME_DIR","SHERPA_ONNX_MODEL_DIR"]},"install":[{"id":"download-runtime-macos","kind":"download","os":["darwin"],"url":"https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-osx-universal2-shared.tar.bz2","archive":"tar.bz2","extract":true,"stripComponents":1,"targetDir":"~/.openclaw/tools/sherpa-onnx-tts/runtime","label":"Download sherpa-onnx runtime (macOS)"},{"id":"download-runtime-linux-x64","kind":"download","os":["linux"],"url":"https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-linux-x64-shared.tar.bz2","archive":"tar.bz2","extract":true,"stripComponents":1,"targetDir":"~/.openclaw/tools/sherpa-onnx-tts/runtime","label":"Download sherpa-onnx runtime (Linux x64)"},{"id":"download-runtime-win-x64","kind":"download","os":["win32"],"url":"https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-win-x64-shared.tar.bz2","archive":"tar.bz2","extract":true,"stripComponents":1,"targetDir":"~/.openclaw/tools/sherpa-onnx-tts/runtime","label":"Download sherpa-onnx runtime (Windows x64)"},{"id":"download-model-lessac","kind":"download","url":"https://github.com/k2-fsa/sherpa-onnx/releases/download/tts-models/vits-piper-en_US-lessac-high.tar.bz2","archive":"tar.bz2","extract":true,"targetDir":"~/.openclaw/tools/sherpa-onnx-tts/models","label":"Download Piper en_US lessac (high)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🗣️",
+        "os": ["darwin", "linux", "win32"],
+        "requires": { "env": ["SHERPA_ONNX_RUNTIME_DIR", "SHERPA_ONNX_MODEL_DIR"] },
+        "install":
+          [
+            {
+              "id": "download-runtime-macos",
+              "kind": "download",
+              "os": ["darwin"],
+              "url": "https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-osx-universal2-shared.tar.bz2",
+              "archive": "tar.bz2",
+              "extract": true,
+              "stripComponents": 1,
+              "targetDir": "~/.openclaw/tools/sherpa-onnx-tts/runtime",
+              "label": "Download sherpa-onnx runtime (macOS)",
+            },
+            {
+              "id": "download-runtime-linux-x64",
+              "kind": "download",
+              "os": ["linux"],
+              "url": "https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-linux-x64-shared.tar.bz2",
+              "archive": "tar.bz2",
+              "extract": true,
+              "stripComponents": 1,
+              "targetDir": "~/.openclaw/tools/sherpa-onnx-tts/runtime",
+              "label": "Download sherpa-onnx runtime (Linux x64)",
+            },
+            {
+              "id": "download-runtime-win-x64",
+              "kind": "download",
+              "os": ["win32"],
+              "url": "https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-win-x64-shared.tar.bz2",
+              "archive": "tar.bz2",
+              "extract": true,
+              "stripComponents": 1,
+              "targetDir": "~/.openclaw/tools/sherpa-onnx-tts/runtime",
+              "label": "Download sherpa-onnx runtime (Windows x64)",
+            },
+            {
+              "id": "download-model-lessac",
+              "kind": "download",
+              "url": "https://github.com/k2-fsa/sherpa-onnx/releases/download/tts-models/vits-piper-en_US-lessac-high.tar.bz2",
+              "archive": "tar.bz2",
+              "extract": true,
+              "targetDir": "~/.openclaw/tools/sherpa-onnx-tts/models",
+              "label": "Download Piper en_US lessac (high)",
+            },
+          ],
+      },
+  }
 ---
 
 # sherpa-onnx-tts
@@ -10,8 +63,8 @@ Local TTS using the sherpa-onnx offline CLI.
 
 ## Install
 
-1) Download the runtime for your OS (extracts into `~/.openclaw/tools/sherpa-onnx-tts/runtime`)
-2) Download a voice model (extracts into `~/.openclaw/tools/sherpa-onnx-tts/models`)
+1. Download the runtime for your OS (extracts into `~/.openclaw/tools/sherpa-onnx-tts/runtime`)
+2. Download a voice model (extracts into `~/.openclaw/tools/sherpa-onnx-tts/models`)
 
 Update `~/.openclaw/openclaw.json`:
 
@@ -22,11 +75,11 @@ Update `~/.openclaw/openclaw.json`:
       "sherpa-onnx-tts": {
         env: {
           SHERPA_ONNX_RUNTIME_DIR: "~/.openclaw/tools/sherpa-onnx-tts/runtime",
-          SHERPA_ONNX_MODEL_DIR: "~/.openclaw/tools/sherpa-onnx-tts/models/vits-piper-en_US-lessac-high"
-        }
-      }
-    }
-  }
+          SHERPA_ONNX_MODEL_DIR: "~/.openclaw/tools/sherpa-onnx-tts/models/vits-piper-en_US-lessac-high",
+        },
+      },
+    },
+  },
 }
 ```
 
@@ -43,6 +96,7 @@ export PATH="{baseDir}/bin:$PATH"
 ```
 
 Notes:
+
 - Pick a different model from the sherpa-onnx `tts-models` release if you want another voice.
 - If the model dir has multiple `.onnx` files, set `SHERPA_ONNX_MODEL_FILE` or pass `--model-file`.
 - You can also pass `--tokens-file` or `--data-dir` to override the defaults.

skills/skill-creator/SKILL.md

@@ -349,7 +349,6 @@ scripts/package_skill.py <path/to/skill-folder> ./dist
 The packaging script will:
 
 1. **Validate** the skill automatically, checking:
-
    - YAML frontmatter format and required fields
    - Skill naming conventions and directory structure
    - Description completeness and quality

skills/slack/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: slack
 description: Use when you need to control Slack from OpenClaw via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.
-metadata: {"openclaw":{"emoji":"💬","requires":{"config":["channels.slack"]}}}
+metadata: { "openclaw": { "emoji": "💬", "requires": { "config": ["channels.slack"] } } }
 ---
 
 # Slack Actions
@@ -22,13 +22,13 @@ Message context lines include `slack message id` and `channel` fields you can re
 
 ### Action groups
 
-| Action group | Default | Notes |
-| --- | --- | --- |
-| reactions | enabled | React + list reactions |
-| messages | enabled | Read/send/edit/delete |
-| pins | enabled | Pin/unpin/list |
-| memberInfo | enabled | Member info |
-| emojiList | enabled | Custom emoji list |
+| Action group | Default | Notes                  |
+| ------------ | ------- | ---------------------- |
+| reactions    | enabled | React + list reactions |
+| messages     | enabled | Read/send/edit/delete  |
+| pins         | enabled | Pin/unpin/list         |
+| memberInfo   | enabled | Member info            |
+| emojiList    | enabled | Custom emoji list      |
 
 ### React to a message
 

skills/songsee/SKILL.md

@@ -2,7 +2,24 @@
 name: songsee
 description: Generate spectrograms and feature-panel visualizations from audio with the songsee CLI.
 homepage: https://github.com/steipete/songsee
-metadata: {"openclaw":{"emoji":"🌊","requires":{"bins":["songsee"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/songsee","bins":["songsee"],"label":"Install songsee (brew)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🌊",
+        "requires": { "bins": ["songsee"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/songsee",
+              "bins": ["songsee"],
+              "label": "Install songsee (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # songsee
@@ -10,12 +27,14 @@ metadata: {"openclaw":{"emoji":"🌊","requires":{"bins":["songsee"]},"install":
 Generate spectrograms + feature panels from audio.
 
 Quick start
+
 - Spectrogram: `songsee track.mp3`
 - Multi-panel: `songsee track.mp3 --viz spectrogram,mel,chroma,hpss,selfsim,loudness,tempogram,mfcc,flux`
 - Time slice: `songsee track.mp3 --start 12.5 --duration 8 -o slice.jpg`
 - Stdin: `cat track.mp3 | songsee - --format png -o out.png`
 
 Common flags
+
 - `--viz` list (repeatable or comma-separated)
 - `--style` palette (classic, magma, inferno, viridis, gray)
 - `--width` / `--height` output size
@@ -25,5 +44,6 @@ Common flags
 - `--format` jpg|png
 
 Notes
+
 - WAV/MP3 decode native; other formats use ffmpeg if available.
 - Multiple `--viz` renders a grid.

skills/sonoscli/SKILL.md

@@ -2,7 +2,24 @@
 name: sonoscli
 description: Control Sonos speakers (discover/status/play/volume/group).
 homepage: https://sonoscli.sh
-metadata: {"openclaw":{"emoji":"🔊","requires":{"bins":["sonos"]},"install":[{"id":"go","kind":"go","module":"github.com/steipete/sonoscli/cmd/sonos@latest","bins":["sonos"],"label":"Install sonoscli (go)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🔊",
+        "requires": { "bins": ["sonos"] },
+        "install":
+          [
+            {
+              "id": "go",
+              "kind": "go",
+              "module": "github.com/steipete/sonoscli/cmd/sonos@latest",
+              "bins": ["sonos"],
+              "label": "Install sonoscli (go)",
+            },
+          ],
+      },
+  }
 ---
 
 # Sonos CLI
@@ -10,17 +27,20 @@ metadata: {"openclaw":{"emoji":"🔊","requires":{"bins":["sonos"]},"install":[{
 Use `sonos` to control Sonos speakers on the local network.
 
 Quick start
+
 - `sonos discover`
 - `sonos status --name "Kitchen"`
 - `sonos play|pause|stop --name "Kitchen"`
 - `sonos volume set 15 --name "Kitchen"`
 
 Common tasks
+
 - Grouping: `sonos group status|join|unjoin|party|solo`
 - Favorites: `sonos favorites list|open`
 - Queue: `sonos queue list|play|clear`
 - Spotify search (via SMAPI): `sonos smapi search --service "Spotify" --category tracks "query"`
 
 Notes
+
 - If SSDP fails, specify `--ip <speaker-ip>`.
 - Spotify Web API search is optional and requires `SPOTIFY_CLIENT_ID/SECRET`.

skills/spotify-player/SKILL.md

@@ -2,7 +2,32 @@
 name: spotify-player
 description: Terminal Spotify playback/search via spogo (preferred) or spotify_player.
 homepage: https://www.spotify.com
-metadata: {"openclaw":{"emoji":"🎵","requires":{"anyBins":["spogo","spotify_player"]},"install":[{"id":"brew","kind":"brew","formula":"spogo","tap":"steipete/tap","bins":["spogo"],"label":"Install spogo (brew)"},{"id":"brew","kind":"brew","formula":"spotify_player","bins":["spotify_player"],"label":"Install spotify_player (brew)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🎵",
+        "requires": { "anyBins": ["spogo", "spotify_player"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "spogo",
+              "tap": "steipete/tap",
+              "bins": ["spogo"],
+              "label": "Install spogo (brew)",
+            },
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "spotify_player",
+              "bins": ["spotify_player"],
+              "label": "Install spotify_player (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # spogo / spotify_player
@@ -10,25 +35,30 @@ metadata: {"openclaw":{"emoji":"🎵","requires":{"anyBins":["spogo","spotify_pl
 Use `spogo` **(preferred)** for Spotify playback/search. Fall back to `spotify_player` if needed.
 
 Requirements
+
 - Spotify Premium account.
 - Either `spogo` or `spotify_player` installed.
 
 spogo setup
+
 - Import cookies: `spogo auth import --browser chrome`
 
 Common CLI commands
+
 - Search: `spogo search track "query"`
 - Playback: `spogo play|pause|next|prev`
 - Devices: `spogo device list`, `spogo device set "<name|id>"`
 - Status: `spogo status`
 
 spotify_player commands (fallback)
+
 - Search: `spotify_player search "query"`
 - Playback: `spotify_player playback play|pause|next|previous`
 - Connect device: `spotify_player connect`
 - Like track: `spotify_player like`
 
 Notes
+
 - Config folder: `~/.config/spotify-player` (e.g., `app.toml`).
 - For Spotify Connect integration, set a user `client_id` in config.
 - TUI shortcuts are available via `?` in the app.

skills/summarize/SKILL.md

@@ -2,7 +2,24 @@
 name: summarize
 description: Summarize or extract text/transcripts from URLs, podcasts, and local files (great fallback for “transcribe this YouTube/video”).
 homepage: https://summarize.sh
-metadata: {"openclaw":{"emoji":"🧾","requires":{"bins":["summarize"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/summarize","bins":["summarize"],"label":"Install summarize (brew)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🧾",
+        "requires": { "bins": ["summarize"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/summarize",
+              "bins": ["summarize"],
+              "label": "Install summarize (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # Summarize
@@ -12,6 +29,7 @@ Fast CLI to summarize URLs, local files, and YouTube links.
 ## When to use (trigger phrases)
 
 Use this skill immediately when the user asks any of:
+
 - “use summarize.sh”
 - “what’s this link/video about?”
 - “summarize this URL/article”
@@ -38,6 +56,7 @@ If the user asked for a transcript but it’s huge, return a tight summary first
 ## Model + keys
 
 Set the API key for your chosen provider:
+
 - OpenAI: `OPENAI_API_KEY`
 - Anthropic: `ANTHROPIC_API_KEY`
 - xAI: `XAI_API_KEY`
@@ -63,5 +82,6 @@ Optional config file: `~/.summarize/config.json`
 ```
 
 Optional services:
+
 - `FIRECRAWL_API_KEY` for blocked sites
 - `APIFY_API_TOKEN` for YouTube fallback

skills/things-mac/SKILL.md

@@ -2,7 +2,25 @@
 name: things-mac
 description: Manage Things 3 via the `things` CLI on macOS (add/update projects+todos via URL scheme; read/search/list from the local Things database). Use when a user asks OpenClaw to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.
 homepage: https://github.com/ossianhempel/things3-cli
-metadata: {"openclaw":{"emoji":"✅","os":["darwin"],"requires":{"bins":["things"]},"install":[{"id":"go","kind":"go","module":"github.com/ossianhempel/things3-cli/cmd/things@latest","bins":["things"],"label":"Install things3-cli (go)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "✅",
+        "os": ["darwin"],
+        "requires": { "bins": ["things"] },
+        "install":
+          [
+            {
+              "id": "go",
+              "kind": "go",
+              "module": "github.com/ossianhempel/things3-cli/cmd/things@latest",
+              "bins": ["things"],
+              "label": "Install things3-cli (go)",
+            },
+          ],
+      },
+  }
 ---
 
 # Things 3 CLI
@@ -10,12 +28,14 @@ metadata: {"openclaw":{"emoji":"✅","os":["darwin"],"requires":{"bins":["things
 Use `things` to read your local Things database (inbox/today/search/projects/areas/tags) and to add/update todos via the Things URL scheme.
 
 Setup
+
 - Install (recommended, Apple Silicon): `GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest`
 - If DB reads fail: grant **Full Disk Access** to the calling app (Terminal for manual runs; `OpenClaw.app` for gateway runs).
 - Optional: set `THINGSDB` (or pass `--db`) to point at your `ThingsData-*` folder.
 - Optional: set `THINGS_AUTH_TOKEN` to avoid passing `--auth-token` for update ops.
 
 Read-only (DB)
+
 - `things inbox --limit 50`
 - `things today`
 - `things upcoming`
@@ -23,11 +43,13 @@ Read-only (DB)
 - `things projects` / `things areas` / `things tags`
 
 Write (URL scheme)
+
 - Prefer safe preview: `things --dry-run add "Title"`
 - Add: `things add "Title" --notes "..." --when today --deadline 2026-01-02`
 - Bring Things to front: `things --foreground add "Title"`
 
 Examples: add a todo
+
 - Basic: `things add "Buy milk"`
 - With notes: `things add "Buy milk" --notes "2% + bananas"`
 - Into a project/area: `things add "Book flights" --list "Travel"`
@@ -42,6 +64,7 @@ Examples: add a todo
   - `EOF`
 
 Examples: modify a todo (needs auth token)
+
 - First: get the ID (UUID column): `things search "milk" --limit 5`
 - Auth: set `THINGS_AUTH_TOKEN` or pass `--auth-token <TOKEN>`
 - Title: `things update --id <UUID> --auth-token <TOKEN> "New title"`
@@ -53,9 +76,11 @@ Examples: modify a todo (needs auth token)
 - Safe preview: `things --dry-run update --id <UUID> --auth-token <TOKEN> --completed`
 
 Delete a todo?
+
 - Not supported by `things3-cli` right now (no “delete/move-to-trash” write command; `things trash` is read-only listing).
 - Options: use Things UI to delete/trash, or mark as `--completed` / `--canceled` via `things update`.
 
 Notes
+
 - macOS-only.
 - `--dry-run` prints the URL and does not open Things.

skills/tmux/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: tmux
 description: Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
-metadata: {"openclaw":{"emoji":"🧵","os":["darwin","linux"],"requires":{"bins":["tmux"]}}}
+metadata:
+  { "openclaw": { "emoji": "🧵", "os": ["darwin", "linux"], "requires": { "bins": ["tmux"] } } }
 ---
 
 # tmux Skill (OpenClaw)
@@ -95,6 +96,7 @@ tmux -S "$SOCKET" capture-pane -p -t agent-1 -S -500
 ```
 
 **Tips:**
+
 - Use separate git worktrees for parallel fixes (no branch conflicts)
 - `pnpm install` first before running codex in fresh clones
 - Check for shell prompt (`❯` or `$`) to detect completion

skills/trello/SKILL.md

@@ -2,7 +2,11 @@
 name: trello
 description: Manage Trello boards, lists, and cards via the Trello REST API.
 homepage: https://developer.atlassian.com/cloud/trello/rest/
-metadata: {"openclaw":{"emoji":"📋","requires":{"bins":["jq"],"env":["TRELLO_API_KEY","TRELLO_TOKEN"]}}}
+metadata:
+  {
+    "openclaw":
+      { "emoji": "📋", "requires": { "bins": ["jq"], "env": ["TRELLO_API_KEY", "TRELLO_TOKEN"] } },
+  }
 ---
 
 # Trello Skill
@@ -24,21 +28,25 @@ Manage Trello boards, lists, and cards directly from OpenClaw.
 All commands use curl to hit the Trello REST API.
 
 ### List boards
+
 ```bash
 curl -s "https://api.trello.com/1/members/me/boards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'
 ```
 
 ### List lists in a board
+
 ```bash
 curl -s "https://api.trello.com/1/boards/{boardId}/lists?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id}'
 ```
 
 ### List cards in a list
+
 ```bash
 curl -s "https://api.trello.com/1/lists/{listId}/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" | jq '.[] | {name, id, desc}'
 ```
 
 ### Create a card
+
 ```bash
 curl -s -X POST "https://api.trello.com/1/cards?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
   -d "idList={listId}" \
@@ -47,18 +55,21 @@ curl -s -X POST "https://api.trello.com/1/cards?key=$TRELLO_API_KEY&token=$TRELL
 ```
 
 ### Move a card to another list
+
 ```bash
 curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
   -d "idList={newListId}"
 ```
 
 ### Add a comment to a card
+
 ```bash
 curl -s -X POST "https://api.trello.com/1/cards/{cardId}/actions/comments?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
   -d "text=Your comment here"
 ```
 
 ### Archive a card
+
 ```bash
 curl -s -X PUT "https://api.trello.com/1/cards/{cardId}?key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
   -d "closed=true"

skills/video-frames/SKILL.md

@@ -2,7 +2,24 @@
 name: video-frames
 description: Extract frames or short clips from videos using ffmpeg.
 homepage: https://ffmpeg.org
-metadata: {"openclaw":{"emoji":"🎞️","requires":{"bins":["ffmpeg"]},"install":[{"id":"brew","kind":"brew","formula":"ffmpeg","bins":["ffmpeg"],"label":"Install ffmpeg (brew)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🎞️",
+        "requires": { "bins": ["ffmpeg"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "ffmpeg",
+              "bins": ["ffmpeg"],
+              "label": "Install ffmpeg (brew)",
+            },
+          ],
+      },
+  }
 ---
 
 # Video Frames (ffmpeg)

skills/voice-call/SKILL.md

@@ -1,7 +1,15 @@
 ---
 name: voice-call
 description: Start voice calls via the OpenClaw voice-call plugin.
-metadata: {"openclaw":{"emoji":"📞","skillKey":"voice-call","requires":{"config":["plugins.entries.voice-call.enabled"]}}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📞",
+        "skillKey": "voice-call",
+        "requires": { "config": ["plugins.entries.voice-call.enabled"] },
+      },
+  }
 ---
 
 # Voice Call
@@ -20,6 +28,7 @@ openclaw voicecall status --call-id <id>
 Use `voice_call` for agent-initiated calls.
 
 Actions:
+
 - `initiate_call` (message, to?, mode?)
 - `continue_call` (callId, message)
 - `speak_to_user` (callId, message)
@@ -27,6 +36,7 @@ Actions:
 - `get_status` (callId)
 
 Notes:
+
 - Requires the voice-call plugin to be enabled.
 - Plugin config lives under `plugins.entries.voice-call.config`.
 - Twilio config: `provider: "twilio"` + `twilio.accountSid/authToken` + `fromNumber`.

skills/wacli/SKILL.md

@@ -2,7 +2,31 @@
 name: wacli
 description: Send WhatsApp messages to other people or search/sync WhatsApp history via the wacli CLI (not for normal user chats).
 homepage: https://wacli.sh
-metadata: {"openclaw":{"emoji":"📱","requires":{"bins":["wacli"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/wacli","bins":["wacli"],"label":"Install wacli (brew)"},{"id":"go","kind":"go","module":"github.com/steipete/wacli/cmd/wacli@latest","bins":["wacli"],"label":"Install wacli (go)"}]}}
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📱",
+        "requires": { "bins": ["wacli"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/wacli",
+              "bins": ["wacli"],
+              "label": "Install wacli (brew)",
+            },
+            {
+              "id": "go",
+              "kind": "go",
+              "module": "github.com/steipete/wacli/cmd/wacli@latest",
+              "bins": ["wacli"],
+              "label": "Install wacli (go)",
+            },
+          ],
+      },
+  }
 ---
 
 # wacli
@@ -12,29 +36,35 @@ Do NOT use `wacli` for normal user chats; OpenClaw routes WhatsApp conversations
 If the user is chatting with you on WhatsApp, you should not reach for this tool unless they ask you to contact a third party.
 
 Safety
+
 - Require explicit recipient + message text.
 - Confirm recipient + message before sending.
 - If anything is ambiguous, ask a clarifying question.
 
 Auth + sync
+
 - `wacli auth` (QR login + initial sync)
 - `wacli sync --follow` (continuous sync)
 - `wacli doctor`
 
 Find chats + messages
+
 - `wacli chats list --limit 20 --query "name or number"`
 - `wacli messages search "query" --limit 20 --chat <jid>`
 - `wacli messages search "invoice" --after 2025-01-01 --before 2025-12-31`
 
 History backfill
+
 - `wacli history backfill --chat <jid> --requests 2 --count 50`
 
 Send
+
 - Text: `wacli send text --to "+14155551212" --message "Hello! Are you free at 3pm?"`
 - Group: `wacli send text --to "1234567890-123456789@g.us" --message "Running 5 min late."`
 - File: `wacli send file --to "+14155551212" --file /path/agenda.pdf --caption "Agenda"`
 
 Notes
+
 - Store dir: `~/.wacli` (override with `--store`).
 - Use `--json` for machine-readable output when parsing.
 - Backfill requires your phone online; results are best-effort.

skills/weather/SKILL.md

@@ -2,7 +2,7 @@
 name: weather
 description: Get current weather and forecasts (no API key required).
 homepage: https://wttr.in/:help
-metadata: {"openclaw":{"emoji":"🌤️","requires":{"bins":["curl"]}}}
+metadata: { "openclaw": { "emoji": "🌤️", "requires": { "bins": ["curl"] } } }
 ---
 
 # Weather
@@ -12,18 +12,21 @@ Two free services, no API keys needed.
 ## wttr.in (primary)
 
 Quick one-liner:
+
 ```bash
 curl -s "wttr.in/London?format=3"
 # Output: London: ⛅️ +8°C
 ```
 
 Compact format:
+
 ```bash
 curl -s "wttr.in/London?format=%l:+%c+%t+%h+%w"
 # Output: London: ⛅️ +8°C 71% ↙5km/h
 ```
 
 Full forecast:
+
 ```bash
 curl -s "wttr.in/London?T"
 ```
@@ -31,6 +34,7 @@ curl -s "wttr.in/London?T"
 Format codes: `%c` condition · `%t` temp · `%h` humidity · `%w` wind · `%l` location · `%m` moon
 
 Tips:
+
 - URL-encode spaces: `wttr.in/New+York`
 - Airport codes: `wttr.in/JFK`
 - Units: `?m` (metric) `?u` (USCS)
@@ -40,6 +44,7 @@ Tips:
 ## Open-Meteo (fallback, JSON)
 
 Free, no key, good for programmatic use:
+
 ```bash
 curl -s "https://api.open-meteo.com/v1/forecast?latitude=51.5&longitude=-0.12&current_weather=true"
 ```