From 7853664324a2c40dd38206d461d92ba322aed6c5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Waili=28=E7=93=A6=E7=A0=BE=29?= Date: Thu, 18 Jun 2026 17:53:39 +0800 Subject: [PATCH] docs(skills): add cross-platform notes so Windows users translate shell examples MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Built-in skills and the cowork assistant rules document shell commands using macOS/Linux (bash/zsh) syntax — heredocs, `&&` chains, `$(...)`, `python3`, `~/` paths, `grep`/`jq` pipes. The execution tool is OS-neutral and the runtime already runs on Windows, but the command text still assumes UNIX, so a model can copy the examples verbatim and fail on Windows (cmd/PowerShell). This is a purely additive fix: insert a "Platform note" block right after the frontmatter of every skill/rule file that contains runnable commands. No existing command is changed (diff is additions-only), so macOS/Linux behaviour is unchanged and there is no regression risk. On Windows the note gives the model an explicit bash→PowerShell translation table instead of relying on it to infer the difference. Scope: - 19 command-heavy skills get the full translation table (officecli-*, moltbook, morph-ppt[-3d], openclaw-setup, aionui-config/-troubleshooting/-webui-public, story-roleplay, mermaid, auto-inject/officecli, auto-inject/aionui-skills) - 4 python/path-only skills get a short note (pdf, x-recruiter, xiaohongshu-recruiter, auto-inject/skill-creator) - cowork assistant rules get a localized guard (zh-CN / en-US / ru-RU) Skills with no runnable commands are intentionally left untouched. Command rewrites (heredoc → temp file, etc.) are deliberately out of scope. Co-Authored-By: Claude Opus 4.8 --- .../builtin-assistants/rules/cowork.en-US.md | 2 ++ .../builtin-assistants/rules/cowork.ru-RU.md | 2 ++ .../builtin-assistants/rules/cowork.zh-CN.md | 2 ++ .../assets/builtin-skills/aionui-config/SKILL.md | 16 ++++++++++++++++ .../aionui-troubleshooting/SKILL.md | 16 ++++++++++++++++ .../builtin-skills/aionui-webui-public/SKILL.md | 16 ++++++++++++++++ .../auto-inject/aionui-skills/SKILL.md | 16 ++++++++++++++++ .../auto-inject/officecli/SKILL.md | 16 ++++++++++++++++ .../auto-inject/skill-creator/SKILL.md | 2 ++ .../assets/builtin-skills/mermaid/SKILL.md | 16 ++++++++++++++++ .../assets/builtin-skills/moltbook/SKILL.md | 16 ++++++++++++++++ .../assets/builtin-skills/morph-ppt-3d/SKILL.md | 16 ++++++++++++++++ .../assets/builtin-skills/morph-ppt/SKILL.md | 16 ++++++++++++++++ .../officecli-academic-paper/SKILL.md | 16 ++++++++++++++++ .../officecli-data-dashboard/SKILL.md | 16 ++++++++++++++++ .../builtin-skills/officecli-docx/SKILL.md | 16 ++++++++++++++++ .../officecli-financial-model/SKILL.md | 16 ++++++++++++++++ .../builtin-skills/officecli-pitch-deck/SKILL.md | 16 ++++++++++++++++ .../builtin-skills/officecli-pptx/SKILL.md | 16 ++++++++++++++++ .../builtin-skills/officecli-word-form/SKILL.md | 16 ++++++++++++++++ .../builtin-skills/officecli-xlsx/SKILL.md | 16 ++++++++++++++++ .../builtin-skills/openclaw-setup/SKILL.md | 16 ++++++++++++++++ .../assets/builtin-skills/pdf/SKILL.md | 2 ++ .../builtin-skills/story-roleplay/SKILL.md | 16 ++++++++++++++++ .../assets/builtin-skills/x-recruiter/SKILL.md | 2 ++ .../xiaohongshu-recruiter/SKILL.md | 2 ++ 26 files changed, 318 insertions(+) diff --git a/crates/aionui-app/assets/builtin-assistants/rules/cowork.en-US.md b/crates/aionui-app/assets/builtin-assistants/rules/cowork.en-US.md index ebcc7f0db..350126963 100644 --- a/crates/aionui-app/assets/builtin-assistants/rules/cowork.en-US.md +++ b/crates/aionui-app/assets/builtin-assistants/rules/cowork.en-US.md @@ -1,5 +1,7 @@ # Cowork Assistant +> **⚠️ Platform note — read before running any command.** The command examples in this guide are written for macOS/Linux (bash/zsh); the execution tool itself is OS-neutral (not bash-specific). **Check your current OS first.** If you are on **Windows**, do not copy the commands verbatim — translate them to PowerShell first: e.g. `a && b` → two steps or `a; if ($?) { b }`; `cat < **⚠️ Примечание о платформе — прочитайте перед выполнением команд.** Примеры команд в этом руководстве написаны для macOS/Linux (bash/zsh); сам инструмент выполнения нейтрален к ОС (не привязан к bash). **Сначала определите текущую ОС.** Если вы на **Windows**, не копируйте команды дословно — сначала переведите их в эквивалент PowerShell: например, `a && b` → два шага или `a; if ($?) { b }`; `cat < **⚠️ 跨平台提醒（执行命令前先读）。** 本指南中的命令示例按 macOS/Linux（bash/zsh）编写，执行工具本身是中性的（不限定 bash）。**先确认当前操作系统**：如果当前是 **Windows**，不要照搬这些命令，应先翻译成 PowerShell 等价写法——例如 `a && b` 拆成两步或 `a; if ($?) { b }`；`cat < **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # AionUi Config Configure a running AionUi installation by calling its backend (aioncore) REST API. diff --git a/crates/aionui-app/assets/builtin-skills/aionui-troubleshooting/SKILL.md b/crates/aionui-app/assets/builtin-skills/aionui-troubleshooting/SKILL.md index fc190bc1f..c346d2770 100644 --- a/crates/aionui-app/assets/builtin-skills/aionui-troubleshooting/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/aionui-troubleshooting/SKILL.md @@ -3,6 +3,22 @@ name: aionui-troubleshooting description: Diagnose a running AionUi installation — locate and inspect conversations (including stuck/running ones), read aioncore logs, check LLM provider health, list scheduled cron jobs and their last run status, inspect teams and member state, and check MCP server health. Use when the user reports that AionUi is misbehaving: a conversation is stuck or errored, an LLM/provider call is failing, a scheduled task did not run, an MCP server has no tools, a team member is hung, or they just ask "what's wrong with AionUi" / "排查一下 aionui". Engine-agnostic — works the same for claude / aionrs / gemini / openclaw conversations. --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # AionUi Troubleshooting Diagnose a running AionUi installation by reading its **project-level** data: diff --git a/crates/aionui-app/assets/builtin-skills/aionui-webui-public/SKILL.md b/crates/aionui-app/assets/builtin-skills/aionui-webui-public/SKILL.md index d391194e1..562d5bc10 100644 --- a/crates/aionui-app/assets/builtin-skills/aionui-webui-public/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/aionui-webui-public/SKILL.md @@ -3,6 +3,22 @@ name: aionui-webui-public description: Expose the user's local AionUi WebUI to the public internet with a near-zero-effort flow. Detects whether the WebUI is running, guides the user to switch it on if needed (the only manual step), self-installs cloudflared cross-platform, opens a Cloudflare quick tunnel, verifies the public URL actually works, then explains the limitations (URL is temporary, must stay running). Use whenever the user wants to reach their AionUi from outside the LAN, over the internet, or share a public link. Distinct from aionui-webui-setup (which covers manual LAN / Tailscale / server config through the settings UI): this skill produces a one-click public link via an automatic tunnel. --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # AionUi WebUI Public Access Guide You help a user turn their local AionUi WebUI (LAN-only at best) into a public internet URL, with the user doing almost nothing. You have a shell (Bash) and run on the same machine as AionUi, so you do the work yourself. The user only does what you architecturally cannot: flip the WebUI toggle in the desktop UI. diff --git a/crates/aionui-app/assets/builtin-skills/auto-inject/aionui-skills/SKILL.md b/crates/aionui-app/assets/builtin-skills/auto-inject/aionui-skills/SKILL.md index 269eaa0f8..67f7bb086 100644 --- a/crates/aionui-app/assets/builtin-skills/auto-inject/aionui-skills/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/auto-inject/aionui-skills/SKILL.md @@ -3,6 +3,22 @@ name: aionui-skills description: 'Access the AionUI Skills registry — discover and download AI agent skills. Use when you need to find a reusable skill for a task or manage your agent credentials on the AionUI Skills platform.' --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # AionUI Skills Market AionUI Skills is a community platform for AI agent skills — discover, download, diff --git a/crates/aionui-app/assets/builtin-skills/auto-inject/officecli/SKILL.md b/crates/aionui-app/assets/builtin-skills/auto-inject/officecli/SKILL.md index 45f3e1ca9..6b4d6d0cd 100644 --- a/crates/aionui-app/assets/builtin-skills/auto-inject/officecli/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/auto-inject/officecli/SKILL.md @@ -3,6 +3,22 @@ name: officecli description: Create, analyze, proofread, and modify Office documents (.docx, .xlsx, .pptx) using the officecli CLI tool. Use when the user wants to create, inspect, check formatting, find issues, add charts, or modify Office documents. --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # officecli AI-friendly CLI for .docx, .xlsx, .pptx. Single binary, no dependencies, no Office installation needed. diff --git a/crates/aionui-app/assets/builtin-skills/auto-inject/skill-creator/SKILL.md b/crates/aionui-app/assets/builtin-skills/auto-inject/skill-creator/SKILL.md index af816a936..b08f80b82 100644 --- a/crates/aionui-app/assets/builtin-skills/auto-inject/skill-creator/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/auto-inject/skill-creator/SKILL.md @@ -4,6 +4,8 @@ description: Guide for creating effective skills. This skill should be used when license: Complete terms in LICENSE.txt --- +> **⚠️ Platform note — read before running any command.** The command examples here are written for **macOS / Linux**. On **Windows**: run `python` (or `py`) instead of `python3`, use `$env:USERPROFILE\…` and backslashes instead of `~/…`, and translate any shell pipes/redirects (`|`, `>`, `&&`) to their PowerShell equivalents before running. The scripts themselves are cross-platform; only the way you invoke them differs. + # Skill Creator This skill provides guidance for creating effective skills. diff --git a/crates/aionui-app/assets/builtin-skills/mermaid/SKILL.md b/crates/aionui-app/assets/builtin-skills/mermaid/SKILL.md index c93764525..bee1577fd 100644 --- a/crates/aionui-app/assets/builtin-skills/mermaid/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/mermaid/SKILL.md @@ -3,6 +3,22 @@ name: mermaid description: Render Mermaid diagrams as SVG or ASCII art using beautiful-mermaid. Use when users need to create flowcharts, sequence diagrams, state diagrams, class diagrams, or ER diagrams. Supports both graphical SVG output and terminal-friendly ASCII/Unicode output. --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # Mermaid Diagram Renderer Render Mermaid diagrams using `beautiful-mermaid` library. Supports 5 diagram types with dual output modes. diff --git a/crates/aionui-app/assets/builtin-skills/moltbook/SKILL.md b/crates/aionui-app/assets/builtin-skills/moltbook/SKILL.md index d873f257b..b86fbceb4 100644 --- a/crates/aionui-app/assets/builtin-skills/moltbook/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/moltbook/SKILL.md @@ -6,6 +6,22 @@ homepage: https://www.moltbook.com metadata: { 'moltbot': { 'emoji': '🦞', 'category': 'social', 'api_base': 'https://www.moltbook.com/api/v1' } } --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # Moltbook The social network for AI agents. Post, comment, upvote, and create communities. diff --git a/crates/aionui-app/assets/builtin-skills/morph-ppt-3d/SKILL.md b/crates/aionui-app/assets/builtin-skills/morph-ppt-3d/SKILL.md index 75f180bb7..aeebd3bf8 100644 --- a/crates/aionui-app/assets/builtin-skills/morph-ppt-3d/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/morph-ppt-3d/SKILL.md @@ -3,6 +3,22 @@ name: morph-ppt-3d description: 3D Morph PPT — extends morph-ppt with GLB model insertion, cinematographic camera, model-content layout, and enriched visual design system. --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # Morph PPT — 3D Extension This skill **extends** `morph-ppt`. All morph-ppt rules (naming, ghosting, design, verification) apply in full. diff --git a/crates/aionui-app/assets/builtin-skills/morph-ppt/SKILL.md b/crates/aionui-app/assets/builtin-skills/morph-ppt/SKILL.md index e2bdb7954..394065b5a 100644 --- a/crates/aionui-app/assets/builtin-skills/morph-ppt/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/morph-ppt/SKILL.md @@ -3,6 +3,22 @@ name: morph-ppt description: "Use this skill when the user wants a .pptx with smooth cross-slide animation — PowerPoint Morph transitions, Keynote-style continuous motion, shapes that grow / move / rotate as the slide advances. Trigger on: 'morph', 'morph transition', 'smooth transition', 'continuous animation across slides', 'Keynote-style transition', 'animated slide sequence', 'shape continuity across slides'. Output is a single .pptx. This skill is a scene layer on top of officecli-pptx — inherits every pptx v2 rule (visual floor, grid, palettes, connector canon, Delivery Gate 1–5a). DO NOT invoke for a generic deck, pitch deck, or board review without cross-slide motion — route those to officecli-pptx base or officecli-pitch-deck." --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # OfficeCLI Morph-PPT Skill **This skill is a scene layer on top of `officecli-pptx`.** Every pptx hard rule — visual delivery floor (title ≥ 36pt / body ≥ 18pt / title ≥ 2× body), 12-column grid on 33.87×19.05cm, canonical palettes, chart-choice decision table, connector canon, shell escape, resident + batch, Delivery Gate 1–5a — is inherited, not re-taught. This file adds only what **Morph** needs on top: cross-slide shape-name binding, Scene Actors vs content prefixing, ghost discipline, `transition=morph` CLI quirks, 52-style visual library lookup, and a morph-specific fresh-eyes Gate 5b extension. diff --git a/crates/aionui-app/assets/builtin-skills/officecli-academic-paper/SKILL.md b/crates/aionui-app/assets/builtin-skills/officecli-academic-paper/SKILL.md index c7d3c52e9..51988d419 100644 --- a/crates/aionui-app/assets/builtin-skills/officecli-academic-paper/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/officecli-academic-paper/SKILL.md @@ -3,6 +3,22 @@ name: officecli-academic-paper description: "Use this skill to build academic-style .docx output: journal / conference / thesis chapters carrying formal citation style (APA, Chicago, IEEE, MLA), numbered equations, figure & table cross-references, footnotes/endnotes, bibliography, or multi-column journal layout. Trigger on: 'research paper', 'journal paper', 'conference paper', 'manuscript', 'thesis', 'APA', 'MLA', 'Chicago', 'IEEE two-column', 'bibliography', 'hanging indent', 'citation style', 'abstract + keywords', 'equation numbering', 'cross-reference', paper with footnotes/endnotes. Output is a single .docx." --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # OfficeCLI Academic Paper Skill **This skill is a scene layer on top of `officecli-docx`.** Every docx hard rule — style architecture, heading hierarchy, shell quoting, `break=newPage` alias, belt-and-suspenders page breaks, live PAGE field, Delivery Gate, renderer quirks — is inherited, not re-taught. This file adds only what academic papers need on top: citation styles, equations, SEQ / PAGEREF cross-refs, multi-column journal layout, bibliography hanging indent, abstract/keywords/affiliation block. diff --git a/crates/aionui-app/assets/builtin-skills/officecli-data-dashboard/SKILL.md b/crates/aionui-app/assets/builtin-skills/officecli-data-dashboard/SKILL.md index b73d5e0d1..75419bbc8 100644 --- a/crates/aionui-app/assets/builtin-skills/officecli-data-dashboard/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/officecli-data-dashboard/SKILL.md @@ -3,6 +3,22 @@ name: officecli-data-dashboard description: "Use this skill to build a multi-element Excel dashboard — Dashboard sheet on open, multiple formula-driven KPI cards, multiple charts, sparklines, and conditional formatting — from CSV or tabular input. Trigger on: 'dashboard', 'KPI dashboard', 'analytics dashboard', 'executive dashboard', 'metrics dashboard', 'CSV to dashboard', 'data visualization'. Output is a single .xlsx. Scene-layer on officecli-xlsx: inherits every xlsx hard rule. DO NOT invoke for: a single budget tracker / one-sheet CSV-with-formatting (use xlsx), a 3-statement / DCF / LBO financial model (use financial-model), a weekly report with ≤ 1 chart and < 10 rows (use xlsx)." --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # Data Dashboard (scene-layer on officecli-xlsx) A dashboard is not "a spreadsheet with charts". It is a composition: **one Dashboard sheet the user lands on** with formula-driven KPI cards, cell-range-linked charts, sparklines, and semantic conditional formatting. Everything else (raw data, aggregations) is upstream infrastructure the user should never need to open. This skill teaches the composition pattern. Everything about the xlsx engine — cells, formulas, batch JSON, shell quoting, validate, HTML preview — comes from `officecli-xlsx` and is not re-taught here. diff --git a/crates/aionui-app/assets/builtin-skills/officecli-docx/SKILL.md b/crates/aionui-app/assets/builtin-skills/officecli-docx/SKILL.md index a4399e0a2..8df27b9b1 100644 --- a/crates/aionui-app/assets/builtin-skills/officecli-docx/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/officecli-docx/SKILL.md @@ -3,6 +3,22 @@ name: officecli-docx description: "Use this skill any time a .docx file is involved -- as input, output, or both. This includes: creating Word documents, reports, letters, memos, or proposals; reading, parsing, or extracting text from any .docx file; editing, modifying, or updating existing documents; working with templates, tracked changes, comments, headers/footers, or tables of contents. Trigger whenever the user mentions 'Word doc', 'document', 'report', 'letter', 'memo', or references a .docx filename." --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # OfficeCLI DOCX Skill ## Setup diff --git a/crates/aionui-app/assets/builtin-skills/officecli-financial-model/SKILL.md b/crates/aionui-app/assets/builtin-skills/officecli-financial-model/SKILL.md index 8dbd01d70..f77d8b00e 100644 --- a/crates/aionui-app/assets/builtin-skills/officecli-financial-model/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/officecli-financial-model/SKILL.md @@ -3,6 +3,22 @@ name: officecli-financial-model description: "Use this skill when the user wants to build a financial model — 3-statement model, DCF valuation, LBO, SaaS unit economics, sensitivity / scenario analysis, debt schedule, or fundraising projections — in Excel. Trigger on: 'financial model', '3-statement model', 'P&L + BS + CF', 'DCF', 'WACC', 'NPV', 'terminal value', 'LBO', 'debt schedule', 'cash sweep', 'MOIC', 'IRR / XIRR', 'sensitivity table', 'scenario analysis', 'ARR model', 'unit economics', 'CAC / LTV', 'cap table forecast'. Output is a single formula-driven .xlsx. This skill is a scene layer on top of officecli-xlsx — it inherits every xlsx v2 rule (4-color code, visual floor, number formats, cache-drift, Known Issues, Delivery Gate minimum cycle). DO NOT invoke for a simple budget tracker, CSV dump, or operational KPI sheet — route those to officecli-xlsx base." --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # OfficeCLI Financial-Model Skill **This skill is a scene layer on top of `officecli-xlsx`.** Every xlsx hard rule — shell quoting, incremental execution, Help-First Rule, visual delivery floor, CFO 4-color code (blue input / black formula / green cross-sheet / yellow-fill assumption), number-format standards (years as text, zero as `-`, `%` one decimal, negatives in parens), assumption-cell discipline, CSV batch import, chart data-feed forms (a/b/c), the 5-gate Delivery cycle, cache-drift guidance, Known Issues (the cross-sheet `!` trap, batch + resident for formulas, renderer caveats) — is **inherited, not re-taught**. This file adds only what a **financial model** requires on top: three-zone architecture, 3 model-type recipes (3-statement / DCF / LBO), sensitivity + scenario protocols, financial-function patterns, circular-reference discipline, and model-specific Delivery Gates 4–6. diff --git a/crates/aionui-app/assets/builtin-skills/officecli-pitch-deck/SKILL.md b/crates/aionui-app/assets/builtin-skills/officecli-pitch-deck/SKILL.md index 007c10e87..034d91d4a 100644 --- a/crates/aionui-app/assets/builtin-skills/officecli-pitch-deck/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/officecli-pitch-deck/SKILL.md @@ -3,6 +3,22 @@ name: officecli-pitch-deck description: "Use this skill when the user is building a fundraising / investor pitch deck — seed, Series A / B / C, convertible note, SAFE round, strategic raise. Trigger on: 'pitch deck', 'investor deck', 'Series A deck', 'Series B deck', 'Series C deck', 'fundraising deck', 'seed pitch', 'VC deck', 'raising capital', 'term sheet presentation'. Output is a single .pptx. This skill is a scene layer on top of officecli-pptx — inherits every pptx v2 rule (visual floor, grid, palettes, connector canon, Delivery Gate). DO NOT invoke for a generic board review, sales deck, all-hands, or product launch — route those to officecli-pptx base." --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # OfficeCLI Pitch Deck Skill **This skill is a scene layer on top of `officecli-pptx`.** Every pptx hard rule — visual delivery floor (title ≥ 36pt / body ≥ 18pt / title ≥ 2× body), 12-column grid on 33.87×19.05cm, 4 canonical palettes, chart-choice decision table, connector canon (`shape` / `from` / `to` / `tailEnd=triangle`), shell escape, resident + batch, Delivery Gate 1–5a — is inherited, not re-taught. This file adds only what **fundraising** needs on top: stage diagnosis (A / B / C), 5 赛道 arc templates, 10 key-slide recipes (cover / problem / solution / market / product / model / traction / team / financials / ask), pitch-specific numbers convention, a VC ship-check, and a pitch-specific fresh-eyes Gate 6. diff --git a/crates/aionui-app/assets/builtin-skills/officecli-pptx/SKILL.md b/crates/aionui-app/assets/builtin-skills/officecli-pptx/SKILL.md index 57e00d703..5085e8a46 100644 --- a/crates/aionui-app/assets/builtin-skills/officecli-pptx/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/officecli-pptx/SKILL.md @@ -3,6 +3,22 @@ name: officecli-pptx description: "Use this skill any time a .pptx file is involved -- as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file; editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates, layouts, speaker notes, or comments. Trigger whenever the user mentions 'deck', 'slides', 'presentation', 'pitch', or references a .pptx filename." --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # OfficeCLI PPTX Skill ## Setup diff --git a/crates/aionui-app/assets/builtin-skills/officecli-word-form/SKILL.md b/crates/aionui-app/assets/builtin-skills/officecli-word-form/SKILL.md index b0da92aac..5da1eb5de 100644 --- a/crates/aionui-app/assets/builtin-skills/officecli-word-form/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/officecli-word-form/SKILL.md @@ -3,6 +3,22 @@ name: officecli-word-form description: "Use this skill to create fillable Word forms (.docx) with real Content Controls (SDT) + legacy FormField checkboxes + MERGEFIELD mail-merge placeholders + document protection. Trigger on: 'fillable form', 'form fields', 'content controls', 'SDT', 'word form', 'fill in', 'only editable fields', 'protect document', 'onboarding form', 'HR intake', 'survey template', 'contract / SOW template', 'mail-merge template', 'compliance checklist', 'medical intake questionnaire'. Output is a single .docx where specific fields are editable and the rest is locked. This skill is INDEPENDENT, not a scene layer on docx — payload is `` + `` + `` + `documentProtection`, none of which docx base skill covers. Do NOT trigger for regular reports, letters, memos, academic papers, pitch decks, or any document with no user-fillable fields — route those to officecli-docx or its scene layers." --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # OfficeCLI Word-Form Skill **This skill is INDEPENDENT, not a scene layer on docx.** A form's payload — `` controls, `` legacy fields, `` mail-merge, `documentProtection` — is a distinct element class from docx's paragraph/heading/style primitives. Its QA is different too: docx's Delivery Gate cares about visual layout and live PAGE fields, this skill's cares about data plumbing (protection enforced / alias+tag / items injected / name ≤ 20 / no underscore anti-pattern). **Reverse handoff:** if the user's document has no fillable fields (report, letter, memo, thesis, proposal), route to `officecli-docx` or a docx scene skill — don't use this one. diff --git a/crates/aionui-app/assets/builtin-skills/officecli-xlsx/SKILL.md b/crates/aionui-app/assets/builtin-skills/officecli-xlsx/SKILL.md index f2daa5ff4..e693db357 100644 --- a/crates/aionui-app/assets/builtin-skills/officecli-xlsx/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/officecli-xlsx/SKILL.md @@ -3,6 +3,22 @@ name: officecli-xlsx description: "Use this skill any time a .xlsx file is involved -- as input, output, or both. This includes: creating spreadsheets, financial models, dashboards, or trackers; reading, parsing, or extracting data from any .xlsx file; editing, modifying, or updating existing workbooks; working with formulas, charts, pivot tables, or templates; importing CSV/TSV data into Excel format. Trigger whenever the user mentions 'spreadsheet', 'workbook', 'Excel', 'financial model', 'tracker', 'dashboard', or references a .xlsx/.csv filename." --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # OfficeCLI XLSX Skill ## Setup diff --git a/crates/aionui-app/assets/builtin-skills/openclaw-setup/SKILL.md b/crates/aionui-app/assets/builtin-skills/openclaw-setup/SKILL.md index a8ad6048b..0a2cabcf1 100644 --- a/crates/aionui-app/assets/builtin-skills/openclaw-setup/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/openclaw-setup/SKILL.md @@ -3,6 +3,22 @@ name: openclaw-setup description: 'OpenClaw usage expert: Helps you install, deploy, configure, and use OpenClaw personal AI assistant. Can diagnose issues, create bots, execute automated tasks, etc. Use when users need to install OpenClaw, configure Gateway, set up Channels, create Agents, troubleshoot issues, or perform OpenClaw-related operations.' --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # OpenClaw 使用专家 你是 OpenClaw 使用专家，可以帮助用户安装、部署、配置和使用 OpenClaw 个人 AI 助手。 diff --git a/crates/aionui-app/assets/builtin-skills/pdf/SKILL.md b/crates/aionui-app/assets/builtin-skills/pdf/SKILL.md index decb4a8f4..83a48d5ff 100644 --- a/crates/aionui-app/assets/builtin-skills/pdf/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/pdf/SKILL.md @@ -4,6 +4,8 @@ description: Comprehensive PDF manipulation toolkit for extracting text and tabl license: Proprietary. LICENSE.txt has complete terms --- +> **⚠️ Platform note — read before running any command.** The command examples here are written for **macOS / Linux**. On **Windows**: run `python` (or `py`) instead of `python3`, use `$env:USERPROFILE\…` and backslashes instead of `~/…`, and translate any shell pipes/redirects (`|`, `>`, `&&`) to their PowerShell equivalents before running. The scripts themselves are cross-platform; only the way you invoke them differs. + # PDF Processing Guide ## Overview diff --git a/crates/aionui-app/assets/builtin-skills/story-roleplay/SKILL.md b/crates/aionui-app/assets/builtin-skills/story-roleplay/SKILL.md index 3e51bcd43..367c48c69 100644 --- a/crates/aionui-app/assets/builtin-skills/story-roleplay/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/story-roleplay/SKILL.md @@ -3,6 +3,22 @@ name: story-roleplay description: Parse and apply character cards and world info files in multiple formats (PNG, WebP, JSON), fully compatible with SillyTavern format. Supports automatic parsing, keyword triggering, and dynamic updates. --- +> **⚠️ Platform note — read before running any command.** The shell snippets in this skill are written for **macOS / Linux** (bash/zsh). Always check which OS you are on first. On **Windows** do **not** run them verbatim — the underlying tool/CLI commands are usually cross-platform, but the surrounding shell syntax is not. Translate it to PowerShell before running: +> +> | bash (macOS / Linux) | PowerShell (Windows) | +> | --- | --- | +> | `a && b` | run as two steps, or `a; if ($?) { b }` | +> | `cat <<'EOF' \| tool …` (heredoc) | write the text to a temp file, then pipe/pass that file to the tool | +> | `VAR=$(cmd)` … `$VAR` | `$VAR = cmd` … `$VAR` | +> | `cmd > /dev/null` | `cmd > $null` | +> | `… \| grep PAT` | `… \| Select-String PAT` | +> | `… \| jq …` | `… \| ConvertFrom-Json`, then read the fields | +> | `python3 x.py` | `python x.py` (or `py x.py`) | +> | `~/dir`, `/tmp` | `$env:USERPROFILE\dir`, `$env:TEMP` | +> | `cp` / `mkdir -p` / `rm -rf` | `Copy-Item` / `New-Item -ItemType Directory -Force` / `Remove-Item -Recurse -Force` | +> +> If a command has no obvious Windows equivalent, prefer the built-in file/HTTP tools over raw shell. + # Story Roleplay Skills Parse and apply character cards and world info files for immersive story roleplay experiences. Fully compatible with SillyTavern formats. diff --git a/crates/aionui-app/assets/builtin-skills/x-recruiter/SKILL.md b/crates/aionui-app/assets/builtin-skills/x-recruiter/SKILL.md index 5441a397e..d8bafeb16 100644 --- a/crates/aionui-app/assets/builtin-skills/x-recruiter/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/x-recruiter/SKILL.md @@ -3,6 +3,8 @@ name: x-recruiter description: 用于在 X (x.com) 发布招聘帖子。包含文案规范、图片生成提示和自动化发布脚本。发布 AI 相关岗位或设计类岗位时优先使用。 --- +> **⚠️ Platform note — read before running any command.** The command examples here are written for **macOS / Linux**. On **Windows**: run `python` (or `py`) instead of `python3`, use `$env:USERPROFILE\…` and backslashes instead of `~/…`, and translate any shell pipes/redirects (`|`, `>`, `&&`) to their PowerShell equivalents before running. The scripts themselves are cross-platform; only the way you invoke them differs. + # X Recruiter (X 招聘助手) 本技能用于快速在 X 发布招聘信息，包含文案规则、封面/详情图提示与自动化发布脚本。 diff --git a/crates/aionui-app/assets/builtin-skills/xiaohongshu-recruiter/SKILL.md b/crates/aionui-app/assets/builtin-skills/xiaohongshu-recruiter/SKILL.md index 4d603f86b..00d6b87a0 100644 --- a/crates/aionui-app/assets/builtin-skills/xiaohongshu-recruiter/SKILL.md +++ b/crates/aionui-app/assets/builtin-skills/xiaohongshu-recruiter/SKILL.md @@ -3,6 +3,8 @@ name: xiaohongshu-recruiter description: 用于在小红书上发布高质量的 AI 相关岗位招聘帖子。包含自动生成极客风格的招聘封面图和详情图，并提供自动化发布脚本。当用户需要发布招聘信息、寻找 Agent 设计师或其他 AI 领域人才时使用。 --- +> **⚠️ Platform note — read before running any command.** The command examples here are written for **macOS / Linux**. On **Windows**: run `python` (or `py`) instead of `python3`, use `$env:USERPROFILE\…` and backslashes instead of `~/…`, and translate any shell pipes/redirects (`|`, `>`, `&&`) to their PowerShell equivalents before running. The scripts themselves are cross-platform; only the way you invoke them differs. + # Xiaohongshu Recruiter (小红书招聘助手) 本技能旨在帮助用户快速、专业地在小红书发布 AI 岗位的招聘信息。通过 "Systemic Flux" 设计理念生成符合极客审美的视觉素材，并提供 Playwright 脚本实现半自动化发布。