feat: add sync-skills command for ai tool skill dirs

Signed-off-by: GitHub <noreply@github.com>

Co-authored-by: OhYee <13498329+OhYee@users.noreply.github.com>

Author: Copilot

README.md

@@ -185,6 +185,7 @@ Multi-document YAMLs (`---` separated) let you deploy many agents in one call.
 | `sandbox` | `sb` | Sandboxes + files, processes, contexts, templates, browser | [en](./docs/en/sandbox.md) · [zh](./docs/zh/sandbox.md) |
 | `tool` |  | MCP and FunctionCall tools | [en](./docs/en/tool.md) · [zh](./docs/zh/tool.md) |
 | `skill` |  | Platform skill packages + local execution | [en](./docs/en/skill.md) · [zh](./docs/zh/skill.md) |
+| `sync-skills` |  | Sync platform skills to Claude Code/Codex local skills directories | [en](./docs/en/sync-skills.md) · [zh](./docs/zh/sync-skills.md) |
 | `super-agent` | `sa` | Quickstart / CRUD / declarative / conversation | [en](./docs/en/super-agent.md) · [zh](./docs/zh/super-agent.md) |
 
 ## Documentation

README_zh.md

@@ -181,6 +181,7 @@ ar sa invoke my-helper -m "帮我规划今天的事情" --text-only
 | `sandbox` | `sb` | 沙箱 + 文件、进程、上下文、模板、浏览器 | [en](./docs/en/sandbox.md) · [zh](./docs/zh/sandbox.md) |
 | `tool` |  | MCP 与 FunctionCall 工具 | [en](./docs/en/tool.md) · [zh](./docs/zh/tool.md) |
 | `skill` |  | 平台技能包 + 本地执行 | [en](./docs/en/skill.md) · [zh](./docs/zh/skill.md) |
+| `sync-skills` |  | 将平台 skills 同步到 Claude Code/Codex 本地技能目录 | [en](./docs/en/sync-skills.md) · [zh](./docs/zh/sync-skills.md) |
 | `super-agent` | `sa` | 一键拉起 / CRUD / 声明式 / 会话管理 | [en](./docs/en/super-agent.md) · [zh](./docs/zh/super-agent.md) |
 
 ## 文档

docs/en/index.md

@@ -197,4 +197,5 @@ Errors are written to stderr as JSON:
 | `sandbox` | `sb` | Sandboxes plus file, process, context, template and browser sub-groups | [sandbox.md](./sandbox.md) |
 | `tool` |  | MCP and FunctionCall tools + sub-tool invocation | [tool.md](./tool.md) |
 | `skill` |  | Platform skill packages + local scan/load/exec | [skill.md](./skill.md) |
+| `sync-skills` |  | Sync platform skills to Claude Code/Codex skill directories | [sync-skills.md](./sync-skills.md) |
 | `super-agent` | `sa` | Quickstart REPL, declarative deploy, CRUD, conversations | [super-agent.md](./super-agent.md) |

docs/en/sync-skills.md

@@ -0,0 +1,45 @@
+**English** | [简体中文](../zh/sync-skills.md)
+
+# ar sync-skills
+
+Sync platform Skills to local AI tool skill directories (Claude Code or Codex).
+
+```
+ar sync-skills [tool] [scope] [options]
+```
+
+## Options
+
+| Flag | Type | Required | Default | Description |
+|------|------|----------|---------|-------------|
+| `--claude-code` | flag | yes* |  | Sync to Claude Code skill directory. |
+| `--codex` | flag | yes* |  | Sync to Codex skill directory. |
+| `--user` | flag | yes** |  | Sync to user-level directory. |
+| `--project` | flag | yes** |  | Sync to project-level directory. |
+| `--workspace` | multi | no | all | Workspace filter, repeatable. |
+| `--delete-unmanaged` | flag | no | false | Delete local skills outside selected workspace scope (with confirmation). |
+| `-y`, `--yes` | flag | no | false | Skip confirmation prompts. |
+
+\* Exactly one of `--claude-code` or `--codex` is required.  
+\** Exactly one of `--user` or `--project` is required.
+
+## Behavior
+
+- By default, all platform skills are selected (unless `--workspace` is provided).
+- Before downloading/updating skills, the CLI asks for confirmation.
+- Sync checks local metadata and only downloads skills that are missing or outdated.
+- When `--delete-unmanaged` is enabled, local skill directories not in the selected
+  managed scope can be removed after confirmation.
+
+## Examples
+
+```bash
+# Sync skills from workspace abc + def into user-level Claude Code skills
+ar sync-skills --claude-code --user --workspace abc --workspace def
+
+# Sync skills from workspace abc into project-level Codex skills
+ar sync-skills --codex --project --workspace abc
+
+# Sync all skills and also remove unmanaged local skills
+ar sync-skills --claude-code --project --delete-unmanaged
+```

docs/zh/index.md

@@ -193,4 +193,5 @@ ar sandbox exec "$SANDBOX" --code "print('hello')"
 | `sandbox` | `sb` | 沙箱以及 file / process / context / template / browser 子组 | [sandbox.md](./sandbox.md) |
 | `tool` |  | MCP 与 FunctionCall 工具 + 子工具调用 | [tool.md](./tool.md) |
 | `skill` |  | 平台侧技能包 + 本地 scan / load / exec | [skill.md](./skill.md) |
+| `sync-skills` |  | 把平台 skills 同步到 Claude Code/Codex 本地技能目录 | [sync-skills.md](./sync-skills.md) |
 | `super-agent` | `sa` | 一键拉起 REPL、声明式部署、CRUD、会话管理 | [super-agent.md](./super-agent.md) |

docs/zh/sync-skills.md

@@ -0,0 +1,44 @@
+[English](../en/sync-skills.md) | **简体中文**
+
+# ar sync-skills
+
+把平台上的 Skill 同步到本地 AI 工具技能目录（Claude Code 或 Codex）。
+
+```
+ar sync-skills [tool] [scope] [options]
+```
+
+## 参数
+
+| Flag | 类型 | 必填 | 默认 | 说明 |
+|------|------|------|------|------|
+| `--claude-code` | flag | 是* |  | 同步到 Claude Code 技能目录。 |
+| `--codex` | flag | 是* |  | 同步到 Codex 技能目录。 |
+| `--user` | flag | 是** |  | 同步到用户级目录。 |
+| `--project` | flag | 是** |  | 同步到项目级目录。 |
+| `--workspace` | multi | 否 | 全部 | 工作空间过滤，可重复。 |
+| `--delete-unmanaged` | flag | 否 | false | 删除不在所选管控范围内的本地技能目录（需确认）。 |
+| `-y`、`--yes` | flag | 否 | false | 跳过确认提示。 |
+
+\* `--claude-code` 与 `--codex` 二选一。  
+\** `--user` 与 `--project` 二选一。
+
+## 行为说明
+
+- 默认同步全部平台 Skill（除非传入 `--workspace`）。
+- 在下载/更新 Skill 前会先进行用户确认。
+- 同步会检查本地元数据，仅下载缺失或有更新的 Skill。
+- 开启 `--delete-unmanaged` 时，会在确认后删除不在当前管控范围内的本地 Skill 目录。
+
+## 示例
+
+```bash
+# 将 workspace abc + def 的 skills 同步到用户级 Claude Code 目录
+ar sync-skills --claude-code --user --workspace abc --workspace def
+
+# 将 workspace abc 的 skills 同步到项目级 Codex 目录
+ar sync-skills --codex --project --workspace abc
+
+# 同步全部 skills，并删除不在管控范围内的本地 skills
+ar sync-skills --claude-code --project --delete-unmanaged
+```