> ## Documentation Index
> Fetch the complete documentation index at: https://docs.veadk.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 管理平台技能与本地技能包

`skill` 管理 AgentKit 平台上的技能与技能空间；`skills` 用于安全壳生成、上传、下载和成对发布真实技能与安全壳技能

## 命令总览

| 命令 | 说明 |
| - | - |
| `skill list` | 列出平台技能。 |
| `skill show` | 查看技能详情。 |
| `skill versions` | 列出技能版本。 |
| `skill spaces` | 列出技能空间。 |
| `skill delete` | 删除平台技能。 |
| `skills secure` | 从本地技能目录生成安全壳 Skill。 |
| `skills upload` | 上传本地或 GitHub 技能包 |
| `skills download` | 下载指定技能版本 |
| `skills download-space` | 下载整个技能空间 |
| `skills publish-secure` | 成对发布真实技能与安全壳技能 |

## skill list

列出技能。

| 标志/参数 | 说明 | 默认值 |
| - | - | - |
| `-r, --region <region>` | 所选云厂商的区域 | 当前云环境 |
| `-p, --project <name>` | 项目名称 | default |
| `--json` | 输出原始 JSON | `false` |

```bash lines theme={null}
agentkit skill list
```

## skill show

查看某个技能的详情。

| 标志/参数 | 说明 | 默认值 |
| - | - | - |
| `<id>` | 技能 ID（必填） | 无 |
| `-r, --region <region>` | 所选云厂商的区域 | 当前云环境 |
| `--json` | 输出原始 JSON | `false` |

```bash lines theme={null}
agentkit skill show sk-xxxxxxxx
```

## skill versions

列出某个技能的版本。

| 标志/参数 | 说明 | 默认值 |
| - | - | - |
| `<id>` | 技能 ID（必填） | 无 |
| `-r, --region <region>` | 所选云厂商的区域 | 当前云环境 |
| `--json` | 输出原始 JSON | `false` |

```bash lines theme={null}
agentkit skill versions sk-xxxxxxxx
```

## skill spaces

列出技能空间。

| 标志/参数 | 说明 | 默认值 |
| - | - | - |
| `-r, --region <region>` | 所选云厂商的区域 | 当前云环境 |
| `--json` | 输出原始 JSON | `false` |

```bash lines theme={null}
agentkit skill spaces
```

## skill delete

删除一个技能。

| 标志/参数 | 说明 | 默认值 |
| - | - | - |
| `<id>` | 技能 ID（必填） | 无 |
| `-r, --region <region>` | 所选云厂商的区域 | 当前云环境 |
| `-y, --yes` | 跳过确认提示 | `false` |

<Warning>
  删除前用 `skill show` 核对技能 ID，并确认现有空间和智能体不再需要该技能。删除会影响后续使用，`--yes` 会跳过确认
</Warning>

```bash lines theme={null}
agentkit skill delete sk-xxxxxxxx --yes
```

## skills secure

从本地技能目录批量生成安全壳 Skill。源目录应包含一个或多个子目录，每个子目录内有 `SKILL.md`，且 frontmatter 至少包含 `name` 与 `description`。命令会为每个技能生成同名输出目录，并只保留面向托管智能体安装的调用说明，不复制真实 Skill 的 Prompt、references、scripts、依赖或凭证。

| 标志/参数 | 说明 | 默认值 |
| - | - | - |
| `<sourceSkillsDir>` | 本地技能根目录，下面的每个技能子目录都应包含 `SKILL.md`。 | 必填 |
| `-o, --output <dir>` | 输出目录。 | 源目录同级的 `<sourceSkillsDir>-secure` |
| `--force` | 覆盖已经存在的生成文件。 | `false` |
| `--json` | 输出原始 JSON。 | `false` |

例如，先创建目录 `skills/report`，并保存以下完整的最小技能文件

```markdown title="skills/report/SKILL.md" lines theme={null}
---
name: report
description: Summarize supplied project notes
---
Read the supplied notes and return a summary of completed work and open questions.
```

以下命令只生成本地安全壳文件，不上传技能、不创建技能空间；真实技能与沙箱的绑定见 `skills publish-secure`

```bash lines theme={null}
agentkit skills secure ./skills

agentkit skills secure ./skills --output ./skills-secure --force
```

生成结果适用于只需要提交任务、轮询进度并展示结果的托管智能体。真实 Skill 的执行仍发生在 AgentKit Skill Sandbox 中。

## skills upload

将技能包上传到所选平台，每个技能的 `SKILL.md` 必须包含 `name` 和 `description`

<Warning>
  上传会将技能正文、脚本和资源发送到目标平台，并可能创建 TOS 存储资源。请检查技能目录，避免包含 `.env`、密钥或其他不应上传的文件
</Warning>

| 标志/参数 | 说明 | 默认值 |
| - | - | - |
| `<skillsDir>` | 包含 `SKILL.md` 的目录、含多个技能子目录的根目录，或 GitHub 目录 URL | 必填 |
| `--source <source>` | 上传目标：`ark_ma` 或 `agentkit` | `SKILL_SOURCE` → `ark_ma` |
| `--api-key <key>` | 火山方舟 API Key，仅用于 `ark_ma` | `ARK_API_KEY` |
| `--endpoint <url>` | 火山方舟技能上传地址 | `https://ark.cn-beijing.volces.com/api/v3/skills` |
| `--skill-space-id <ids>` | AgentKit 技能空间 ID，可用逗号分隔多个空间 | `SKILL_SPACE_ID` |
| `-r, --region <region>` | AgentKit 区域 | 云厂商与配置 |
| `-p, --project <name>` | AgentKit 上传所用 TOS 项目 | `default` |
| `--display-title <title>` | 单个火山方舟技能的显示标题 | — |
| `--dry-run` | 校验并展示上传计划，不发送文件 | `false` |
| `--json` | 输出 JSON 结果 | `false` |

```bash lines theme={null}
agentkit skills upload ./skills --source agentkit --skill-space-id ss-example --dry-run
agentkit skills upload ./skills --source agentkit --skill-space-id ss-example
agentkit skills upload ./skills/report --source ark_ma
```

未指定 AgentKit 技能空间时，交互终端会列出空间供选择；非交互环境必须设置 `--skill-space-id` 或 `SKILL_SPACE_ID`。`--dry-run` 不要求选择空间，也不创建远端资源。上传限制为每个技能最多 500 个文件、单文件最多 25 MiB、文件总量与压缩包各最多 50 MiB

GitHub 来源使用 `https://github.com/<owner>/<repo>/tree/<ref>/<path>`，需要本地 Git。火山方舟使用 `ARK_API_KEY`；AgentKit 使用所选火山引擎或 BytePlus 账号的云凭据

## skills download

下载指定技能并解压到本地目录

<Warning>
  解压会覆盖目标目录中的同名文件，不额外确认；请使用新的输出目录
</Warning>

| 标志/参数 | 说明 | 默认值 |
| - | - | - |
| `<id>` | 技能 ID | 必填 |
| `-o, --output <dir>` | 解压输出目录 | `./<id>` |
| `--source <source>` | 当前仅支持 `agentkit` | `SKILL_SOURCE` → `agentkit` |
| `--version <version>` | 指定下载版本 | 平台当前版本 |
| `-r, --region <region>` | AgentKit 区域 | 云厂商与配置 |
| `-p, --project <name>` | AgentKit 项目 | — |
| `--json` | 输出 JSON 结果 | `false` |

```bash lines theme={null}
agentkit skills download s-example --output ./downloaded-skill --source agentkit
```

需要本地 `unzip`。压缩包最大 50 MiB，不安全的解压路径会被拒绝；`ark_ma` 尚不支持下载

## skills download-space

下载空间内所有技能，按技能 ID 建立子目录，并使用该空间绑定的技能版本

<Warning>
  解压会覆盖目标目录中的同名文件，不额外确认；请使用新的输出目录
</Warning>

| 标志/参数 | 说明 | 默认值 |
| - | - | - |
| `<skillSpaceId>` | 技能空间 ID | 必填 |
| `-o, --output <dir>` | 解压输出目录 | `./<skillSpaceId>` |
| `--source <source>` | 当前仅支持 `agentkit` | `SKILL_SOURCE` → `agentkit` |
| `-r, --region <region>` | AgentKit 区域 | 云厂商与配置 |
| `-p, --project <name>` | AgentKit 项目 | — |
| `--json` | 输出 JSON 结果 | `false` |

```bash lines theme={null}
agentkit skills download-space ss-example --output ./downloaded-space --source agentkit
```

需要本地 `unzip`。压缩包最大 50 MiB，不安全的解压路径会被拒绝；`ark_ma` 尚不支持下载

## skills publish-secure

将真实技能与可独立调用的安全壳技能发布到两个新建的技能空间，随后读取两个空间核验发布结果。安全壳保留技能名称、描述和远程调用脚本，不包含真实技能的指令与资源

<Warning>
  实际发布会创建两个技能空间并上传技能；真实空间仍包含完整技能内容，应分别配置两个空间的访问权限。操作可能部分成功，请根据返回的空间 ID 和逐项结果处理失败，重复运行会创建新的空间
</Warning>

| 标志/参数 | 说明 | 默认值 |
| - | - | - |
| `<skillsDir>` | 本地技能目录或 GitHub 目录 URL | 必填 |
| `--space-name-prefix <name>` | 两个新技能空间的名称前缀 | 从来源目录名生成 |
| `-o, --output-dir <dir>` | 保留生成的安全壳技能 | 不保留 |
| `-r, --region <region>` | AgentKit 区域 | 云厂商与配置 |
| `-p, --project <name>` | AgentKit 项目 | `default` |
| `--force` | 覆盖输出目录中的生成文件 | `false` |
| `--dry-run` | 校验并显示计划，不创建空间或上传技能 | `false` |
| `-y, --yes` | 跳过发布确认；非交互环境必填 | `false` |
| `--json` | 输出 JSON 结果 | `false` |

```bash lines theme={null}
agentkit skills publish-secure ./skills --dry-run
agentkit skills publish-secure ./skills --space-name-prefix reports --output-dir ./secure-skills --yes
```

空间名称为 `<prefix>_real_<suffix>` 与 `<prefix>_secure_<suffix>`，后缀随机生成。交互终端先显示计划再请求确认，`--json` 或 CI 等非交互环境必须显式传入 `--yes`

执行安全壳前，为真实空间创建或选择已绑定该空间的 `Skill` 沙箱工具，在客户端运行环境安装 `agentkit-sdk-python>=0.8,<0.9`，并通过 SDK 默认凭据链提供凭据。设置 `AGENTKIT_TOOL_ID` 为该工具 ID；`AGENTKIT_REGION` 默认 `cn-beijing`，其他区域需显式配置