# save_cloud_skill

保存或更新可复用的 Cloud Skill，并创建它的下一个版本化 revision。

- Canonical: https://docs.xmemo.dev/zh/docs/tools/save-cloud-skill
- Locale: zh-CN
- Content-Locale: zh-CN
- Canonical-Content-Digest: 04d9414473b38ac4dc5cc2f5060d7c6b004a36ed2d57cf20fbda34994c123a3f
- Edition-Digest: 5a2a6d9a416d4c5509b4fb7f540c8ec3c75d578e3384327db89b7f7326a59702
- Source-Revision: sha256:718059b6bf8760a2fbcf899877706dcb1219cbf46ea3053aecd788d1274ab789

## Tool Reference: `save_cloud_skill`

### Purpose

创建或更新可复用的 Cloud Skill，并为其 instructions 和 typed components 生成下一个不可变 revision。

### Parameters

- `name` (string, required): 人类可读的 skill name；空 name 会被拒绝。
- `instructions` (string, required): Root procedure body；必填，UTF-8 编码后限制为 64 KiB。
- `slug` (string, optional, default: derived from name): 可选的小写 skill identifier，必须符合 1–64 字符的 slug contract。
- `description` (string, optional, default: empty): 可选的 discovery text，由 Level 0 query discovery 返回。
- `publish` (boolean, optional, default: true): Publish intent；personal scope 可直接 publish，而 team scope 会创建 proposed revision。
- `components_json` (JSON array string, optional, default: []): 可选的 component objects，包含 type、logical_path、content 或 artifact_ref、mime_type 和 metadata；最多 50 个，每个 content body 限制为 128 KiB。

### Returns

JSON CloudSkillResponseEnvelope，包含 object='cloud_skill'、schema_version='xmemo.cloud_skill.v1'、kind='root'、render_status、warnings，以及包含 skill_id、slug、name、description、revision_id、revision_number、instructions、canonical_hash 和 typed resources manifest 的 data。

### Errors

- Authorization failure：MCP token 缺少 memory:write，或调用者无法写入 resolved personal/team scope。
- Validation failure：name 或 instructions 为空，slug 无效，或 instruction body 超过 64 KiB。
- Component validation failure：components_json 不是 JSON array，component path 为空/绝对路径/类似 traversal/保留名/重复，type 无效，或 component 超过 128 KiB。
- Scope lifecycle：personal publish 是直接的；team publish 会保存为 proposed，并需要 team review flow。

### Examples

#### 发布 personal procedure



```typescript
save_cloud_skill({
  name: "deployment-procedure",
  instructions: "Check the release, run the smoke test, and report the result.",
  slug: "deployment-procedure",
  description: "A bounded deployment verification procedure",
  publish: true
})
```

### Related Tools

- [recall_cloud_skill](/docs/tools/recall-cloud-skill): 保存后发现 skill、加载 root manifest，或读取 pinned resource。
- [execute_cloud_skill](/docs/tools/execute-cloud-skill): 只有在 recall 目标 revision 后，才运行声明的 script component。
- [remember](/docs/tools/remember): 不需要可复用 procedure 时，使用普通的持久 memory。

## 只发布经过审查的 procedure

提供持久 instructions 和可选的 typed components。不要将 credentials 或 private material 放入 skill body；该工具会把 procedure 保存在经过认证的 personal 或 team scope 中。