iOfficeAI · BubbleWolf · Apr 4, 2026 · Apr 4, 2026 · Apr 4, 2026 · Apr 4, 2026
diff --git a/README.md b/README.md
@@ -66,13 +66,19 @@ curl -fsSL https://officecli.ai/SKILL.md
 
 That's it. The skill file teaches the agent how to install the binary and use all commands.
 
-> **Technical details:** OfficeCLI ships with a [SKILL.md](SKILL.md) (239 lines, ~8K tokens) that covers command syntax, architecture, and common pitfalls. After installation, your agent can immediately create, read, and modify any Office document.
+> **Technical details:** OfficeCLI ships with a [SKILL.md](SKILL.md) that covers command syntax, architecture, and common pitfalls. After installation, your agent can immediately create, read, and modify any Office document.
 
-## For Humans — Try It with AionUi
+## For Humans
 
-Want to experience the power of OfficeCLI without writing a single command? Install [**AionUi**](https://github.com/iOfficeAI/AionUi) — a desktop app that lets you create and edit Office documents through natural language, powered by OfficeCLI under the hood.
+**Option A — GUI:** Install [**AionUi**](https://github.com/iOfficeAI/AionUi) — a desktop app that lets you create and edit Office documents through natural language, powered by OfficeCLI under the hood. Just describe what you want, and AionUi handles the rest.
 
-Just describe what you want, and AionUi handles the rest.
+**Option B — CLI:** Download the binary for your platform from [GitHub Releases](https://github.com/iOfficeAI/OfficeCLI/releases), then run:
+
+```bash
+officecli install
+```
+
+This copies the binary to your PATH and installs the **officecli skill** into every AI coding agent it detects — Claude Code, Cursor, Windsurf, GitHub Copilot, and more. Your agent can immediately create, read, and edit Office documents on your behalf, no extra configuration needed.
 
 ## For Developers — See It Live in 30 Seconds
 
@@ -99,7 +105,7 @@ That's it. Every `add`, `set`, or `remove` command you run will refresh the prev
 # Create a presentation and add content
 officecli create deck.pptx
 officecli add deck.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2E
-officecli add deck.pptx /slide[1] --type shape \
+officecli add deck.pptx '/slide[1]' --type shape \
   --prop text="Revenue grew 25%" --prop x=2cm --prop y=5cm \
   --prop font=Arial --prop size=24 --prop color=FFFFFF
 
@@ -112,7 +118,7 @@ officecli view deck.pptx outline
 officecli view deck.pptx html
 
 # Get structured JSON for any element
-officecli get deck.pptx /slide[1]/shape[1] --json
+officecli get deck.pptx '/slide[1]/shape[1]' --json
 ```
 
 ```json
@@ -264,7 +270,7 @@ Start simple, go deep only when needed.
 | Layer | Purpose | Commands |
 |-------|---------|----------|
 | **L1: Read** | Semantic views of content | `view` (text, annotated, outline, stats, issues, html) |
-| **L2: DOM** | Structured element operations | `get`, `query`, `set`, `add`, `remove`, `move` |
+| **L2: DOM** | Structured element operations | `get`, `query`, `set`, `add`, `remove`, `move`, `swap` |
 | **L3: Raw XML** | Direct XPath access — universal fallback | `raw`, `raw-set`, `add-part`, `validate` |
 
 ```bash
@@ -278,7 +284,7 @@ officecli add budget.xlsx / --type sheet --prop name="Q2 Report"
 officecli move report.docx /body/p[5] --to /body --index 1
 
 # L3 — raw XML when L2 isn't enough
-officecli raw deck.pptx /slide[1]
+officecli raw deck.pptx '/slide[1]'
 officecli raw-set report.docx document \
   --xpath "//w:p[1]" --action append \
   --xml '<w:r><w:t>Injected text</w:t></w:r>'
@@ -324,7 +330,7 @@ curl -fsSL https://officecli.ai/SKILL.md
 curl -fsSL https://officecli.ai/SKILL.md -o ~/.claude/skills/officecli.md
 ```
 
-**Other agents:** Include the contents of `SKILL.md` (239 lines, ~8K tokens) in your agent's system prompt or tool description.
+**Other agents:** Include the contents of `SKILL.md` in your agent's system prompt or tool description.
 
 </details>
 
@@ -456,7 +462,7 @@ OFFICECLI_SKIP_UPDATE=1 officecli ...          # Skip check for one invocation (
 | [`set`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-set) | Modify element properties |
 | [`add`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-add) | Add element (or clone with `--from <path>`) |
 | [`remove`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-remove) | Remove an element |
-| [`move`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-move) | Move element (`--to <parent> --index N`) |
+| [`move`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-move) | Move element (`--to <parent>`, `--index N`, `--after <path>`, `--before <path>`) |
 | [`swap`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-swap) | Swap two elements |
 | [`validate`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-validate) | Validate against OpenXML schema |
 | [`batch`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-batch) | Multiple operations in one open/save cycle (stdin, `--input`, or `--commands`; stops on first error, `--force` to continue) |
@@ -482,10 +488,10 @@ officecli create report.pptx
 
 # 2. Add content
 officecli add report.pptx / --type slide --prop title="Q4 Results"
-officecli add report.pptx /slide[1] --type shape \
+officecli add report.pptx '/slide[1]' --type shape \
   --prop text="Revenue: $4.2M" --prop x=2cm --prop y=5cm --prop size=28
 officecli add report.pptx / --type slide --prop title="Details"
-officecli add report.pptx /slide[2] --type shape \
+officecli add report.pptx '/slide[2]' --type shape \
   --prop text="Growth driven by new markets" --prop x=2cm --prop y=5cm
 
 # 3. Verify
@@ -495,7 +501,7 @@ officecli validate report.pptx
 # 4. Fix any issues found
 officecli view report.pptx issues --json
 # Address issues based on output, e.g.:
-officecli set report.pptx /slide[1]/shape[1] --prop font=Arial
+officecli set report.pptx '/slide[1]/shape[1]' --prop font=Arial
 ```
 
 ### Template Merge
@@ -588,7 +594,7 @@ yaml-frontmatter:
   ai-agent-compatible: true
   mcp-server: true
   skill-file: SKILL.md
-  skill-file-lines: 239
+
   install-command-unix: curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
   install-command-windows: irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex
 -->
@@ -606,7 +612,7 @@ keywords: office, cli, ai-agent, automation, docx, xlsx, pptx, openxml, document
 ai-agent-compatible: true
 mcp-server: true
 skill-file: SKILL.md
-skill-file-lines: 239
+skill-file-lines: 403
 alternatives: python-docx, openpyxl, python-pptx, libreoffice --headless
 install-command-unix: curl -fsSL https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.sh | bash
 install-command-windows: irm https://raw.githubusercontent.com/iOfficeAI/OfficeCLI/main/install.ps1 | iex

diff --git a/README_ja.md b/README_ja.md
@@ -66,7 +66,7 @@ curl -fsSL https://officecli.ai/SKILL.md
 
 これだけです。スキルファイルがエージェントにバイナリのインストール方法と全コマンドの使い方を教えます。
 
-> **技術詳細：** OfficeCLI には [SKILL.md](SKILL.md)（239行、約8Kトークン）が付属し、コマンド構文、アーキテクチャ、よくある落とし穴をカバーしています。インストール後、エージェントはすぐに Office 文書の作成・読み取り・変更が可能です。
+> **技術詳細：** OfficeCLI には [SKILL.md](SKILL.md) が付属し、コマンド構文、アーキテクチャ、よくある落とし穴をカバーしています。インストール後、エージェントはすぐに Office 文書の作成・読み取り・変更が可能です。
 
 ## 一般ユーザー向け — AionUi をインストールして体験
 
@@ -99,7 +99,7 @@ officecli add deck.pptx / --type slide --prop title="Hello, World!"
 # プレゼンテーションを作成してコンテンツを追加
 officecli create deck.pptx
 officecli add deck.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2E
-officecli add deck.pptx /slide[1] --type shape \
+officecli add deck.pptx '/slide[1]' --type shape \
   --prop text="Revenue grew 25%" --prop x=2cm --prop y=5cm \
   --prop font=Arial --prop size=24 --prop color=FFFFFF
 
@@ -112,7 +112,7 @@ officecli view deck.pptx outline
 officecli view deck.pptx html
 
 # 任意の要素の構造化 JSON を取得
-officecli get deck.pptx /slide[1]/shape[1] --json
+officecli get deck.pptx '/slide[1]/shape[1]' --json
 ```
 
 ```json
@@ -258,7 +258,7 @@ echo '[{"command":"set","path":"/slide[1]/shape[1]","props":{"text":"Hello"}},
 | レイヤー | 用途 | コマンド |
 |---------|------|---------|
 | **L1：読み取り** | コンテンツのセマンティックビュー | `view`（text、annotated、outline、stats、issues、html） |
-| **L2：DOM** | 構造化された要素操作 | `get`、`query`、`set`、`add`、`remove`、`move` |
+| **L2：DOM** | 構造化された要素操作 | `get`、`query`、`set`、`add`、`remove`、`move`、`swap` |
 | **L3：生 XML** | XPath による直接アクセス — 万能フォールバック | `raw`、`raw-set`、`add-part`、`validate` |
 
 ```bash
@@ -272,7 +272,7 @@ officecli add budget.xlsx / --type sheet --prop name="Q2 Report"
 officecli move report.docx /body/p[5] --to /body --index 1
 
 # L3 — L2 では足りない時に生 XML
-officecli raw deck.pptx /slide[1]
+officecli raw deck.pptx '/slide[1]'
 officecli raw-set report.docx document \
   --xpath "//w:p[1]" --action append \
   --xml '<w:r><w:t>Injected text</w:t></w:r>'
@@ -318,7 +318,7 @@ curl -fsSL https://officecli.ai/SKILL.md
 curl -fsSL https://officecli.ai/SKILL.md -o ~/.claude/skills/officecli.md
 ```
 
-**その他のエージェント：** `SKILL.md`（239行、約8Kトークン）の内容をエージェントのシステムプロンプトまたはツール説明に含めてください。
+**その他のエージェント：** `SKILL.md` の内容をエージェントのシステムプロンプトまたはツール説明に含めてください。
 
 </details>
 
@@ -452,7 +452,7 @@ OFFICECLI_SKIP_UPDATE=1 officecli ...          # 単回のチェックをスキ
 | [`set`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-set) | 要素のプロパティを変更 |
 | [`add`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-add) | 要素を追加（または `--from <path>` でクローン） |
 | [`remove`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-remove) | 要素を削除 |
-| [`move`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-move) | 要素を移動（`--to <parent> --index N`） |
+| [`move`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-move) | 要素を移動（`--to <parent>`、`--index N`、`--after <path>`、`--before <path>`） |
 | [`swap`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-swap) | 2つの要素を交換 |
 | [`validate`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-validate) | OpenXML スキーマ検証 |
 | [`batch`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-batch) | 一度の open/save サイクルで複数操作を実行（stdin、`--input`、または `--commands`） |
@@ -478,10 +478,10 @@ officecli create report.pptx
 
 # 2. コンテンツを追加
 officecli add report.pptx / --type slide --prop title="Q4 Results"
-officecli add report.pptx /slide[1] --type shape \
+officecli add report.pptx '/slide[1]' --type shape \
   --prop text="Revenue: $4.2M" --prop x=2cm --prop y=5cm --prop size=28
 officecli add report.pptx / --type slide --prop title="Details"
-officecli add report.pptx /slide[2] --type shape \
+officecli add report.pptx '/slide[2]' --type shape \
   --prop text="Growth driven by new markets" --prop x=2cm --prop y=5cm
 
 # 3. 検証
@@ -491,7 +491,7 @@ officecli validate report.pptx
 # 4. 問題の修正
 officecli view report.pptx issues --json
 # 出力に基づいて問題を修正：
-officecli set report.pptx /slide[1]/shape[1] --prop font=Arial
+officecli set report.pptx '/slide[1]/shape[1]' --prop font=Arial
 ```
 
 ### テンプレートマージ

diff --git a/README_ko.md b/README_ko.md
@@ -66,7 +66,7 @@ curl -fsSL https://officecli.ai/SKILL.md
 
 이게 전부입니다. 스킬 파일이 에이전트에게 바이너리 설치 방법과 모든 명령어 사용법을 알려줍니다.
 
-> **기술 세부사항:** OfficeCLI에는 [SKILL.md](SKILL.md)(239줄, 약 8K 토큰)가 포함되어 있으며, 명령어 구문, 아키텍처, 자주 발생하는 실수를 다룹니다. 설치 후 에이전트는 즉시 Office 문서를 생성, 읽기, 수정할 수 있습니다.
+> **기술 세부사항:** OfficeCLI에는 [SKILL.md](SKILL.md)가 포함되어 있으며, 명령어 구문, 아키텍처, 자주 발생하는 실수를 다룹니다. 설치 후 에이전트는 즉시 Office 문서를 생성, 읽기, 수정할 수 있습니다.
 
 ## 일반 사용자용 — AionUi를 설치하여 체험
 
@@ -99,7 +99,7 @@ officecli add deck.pptx / --type slide --prop title="Hello, World!"
 # 프레젠테이션을 생성하고 콘텐츠 추가
 officecli create deck.pptx
 officecli add deck.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2E
-officecli add deck.pptx /slide[1] --type shape \
+officecli add deck.pptx '/slide[1]' --type shape \
   --prop text="Revenue grew 25%" --prop x=2cm --prop y=5cm \
   --prop font=Arial --prop size=24 --prop color=FFFFFF
 
@@ -112,7 +112,7 @@ officecli view deck.pptx outline
 officecli view deck.pptx html
 
 # 모든 요소의 구조화된 JSON 가져오기
-officecli get deck.pptx /slide[1]/shape[1] --json
+officecli get deck.pptx '/slide[1]/shape[1]' --json
 ```
 
 ```json
@@ -258,7 +258,7 @@ echo '[{"command":"set","path":"/slide[1]/shape[1]","props":{"text":"Hello"}},
 | 레이어 | 용도 | 명령어 |
 |--------|------|--------|
 | **L1: 읽기** | 콘텐츠의 시맨틱 뷰 | `view` (text, annotated, outline, stats, issues, html) |
-| **L2: DOM** | 구조화된 요소 작업 | `get`, `query`, `set`, `add`, `remove`, `move` |
+| **L2: DOM** | 구조화된 요소 작업 | `get`, `query`, `set`, `add`, `remove`, `move`, `swap` |
 | **L3: 원시 XML** | XPath 직접 접근 — 범용 폴백 | `raw`, `raw-set`, `add-part`, `validate` |
 
 ```bash
@@ -272,7 +272,7 @@ officecli add budget.xlsx / --type sheet --prop name="Q2 Report"
 officecli move report.docx /body/p[5] --to /body --index 1
 
 # L3 — L2로 부족할 때 원시 XML
-officecli raw deck.pptx /slide[1]
+officecli raw deck.pptx '/slide[1]'
 officecli raw-set report.docx document \
   --xpath "//w:p[1]" --action append \
   --xml '<w:r><w:t>Injected text</w:t></w:r>'
@@ -318,7 +318,7 @@ curl -fsSL https://officecli.ai/SKILL.md
 curl -fsSL https://officecli.ai/SKILL.md -o ~/.claude/skills/officecli.md
 ```
 
-**기타 에이전트:** `SKILL.md`(239줄, 약 8K 토큰)의 내용을 에이전트의 시스템 프롬프트 또는 도구 설명에 포함하세요.
+**기타 에이전트:** `SKILL.md`의 내용을 에이전트의 시스템 프롬프트 또는 도구 설명에 포함하세요.
 
 </details>
 
@@ -452,7 +452,7 @@ OFFICECLI_SKIP_UPDATE=1 officecli ...          # 단일 실행 시 확인 건너
 | [`set`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-set) | 요소 속성 수정 |
 | [`add`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-add) | 요소 추가 (또는 `--from <path>`로 복제) |
 | [`remove`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-remove) | 요소 삭제 |
-| [`move`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-move) | 요소 이동 (`--to <parent> --index N`) |
+| [`move`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-move) | 요소 이동 (`--to <parent>`, `--index N`, `--after <path>`, `--before <path>`) |
 | [`swap`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-swap) | 두 요소 교체 |
 | [`validate`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-validate) | OpenXML 스키마 검증 |
 | [`batch`](https://github.com/iOfficeAI/OfficeCLI/wiki/command-batch) | 한 번의 open/save 사이클에서 여러 작업 실행 (stdin, `--input`, 또는 `--commands`) |
@@ -478,10 +478,10 @@ officecli create report.pptx
 
 # 2. 콘텐츠 추가
 officecli add report.pptx / --type slide --prop title="Q4 Results"
-officecli add report.pptx /slide[1] --type shape \
+officecli add report.pptx '/slide[1]' --type shape \
   --prop text="Revenue: $4.2M" --prop x=2cm --prop y=5cm --prop size=28
 officecli add report.pptx / --type slide --prop title="Details"
-officecli add report.pptx /slide[2] --type shape \
+officecli add report.pptx '/slide[2]' --type shape \
   --prop text="Growth driven by new markets" --prop x=2cm --prop y=5cm
 
 # 3. 검증
@@ -491,7 +491,7 @@ officecli validate report.pptx
 # 4. 문제 수정
 officecli view report.pptx issues --json
 # 출력에 따라 문제 수정:
-officecli set report.pptx /slide[1]/shape[1] --prop font=Arial
+officecli set report.pptx '/slide[1]/shape[1]' --prop font=Arial
 ```
 
 ### 템플릿 병합