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

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`

agentkit skill list

skill show

查看某个技能的详情。

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

agentkit skill show sk-xxxxxxxx

skill versions

列出某个技能的版本。

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

agentkit skill versions sk-xxxxxxxx

skill spaces

列出技能空间。

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

agentkit skill spaces

skill delete

删除一个技能。

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

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

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，并保存以下完整的最小技能文件

skills/report/SKILL.md

---
name: report
description: Summarize supplied project notes
---
Read the supplied notes and return a summary of completed work and open questions.

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

agentkit skills secure ./skills

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

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

skills upload

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

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

标志/参数	说明	默认值
`<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`

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

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

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

标志/参数	说明	默认值
`<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`

agentkit skills download s-example --output ./downloaded-skill --source agentkit

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

skills download-space

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

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

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

agentkit skills download-space ss-example --output ./downloaded-space --source agentkit

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

skills publish-secure

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

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

标志/参数	说明	默认值
`<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`

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，其他区域需显式配置

开始使用

AI-Friendly

命令参考

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

命令总览

skill list

skill show

skill versions

skill spaces

skill delete

skills secure

skills upload

skills download

skills download-space

skills publish-secure

​命令总览

​skill list

​skill show

​skill versions

​skill spaces

​skill delete

​skills secure

​skills upload

​skills download

​skills download-space

​skills publish-secure

命令总览

skill list

skill show

skill versions

skill spaces

skill delete

skills secure

skills upload

skills download

skills download-space

skills publish-secure