# save_cloud_skill

재사용 가능한 Cloud Skill을 저장하거나 업데이트하고 다음 버전 revision을 생성합니다.

- Canonical: https://docs.xmemo.dev/ko/docs/tools/save-cloud-skill
- Locale: ko-KR
- Content-Locale: ko-KR
- Canonical-Content-Digest: 04d9414473b38ac4dc5cc2f5060d7c6b004a36ed2d57cf20fbda34994c123a3f
- Edition-Digest: 389dcb519250341025db4032a31159f5923f88969b081e66c91a14cd6f5002a2
- Source-Revision: sha256:718059b6bf8760a2fbcf899877706dcb1219cbf46ea3053aecd788d1274ab789

## Tool Reference: `save_cloud_skill`

### Purpose

재사용 가능한 Cloud Skill을 생성하거나 업데이트하고 instructions 및 typed components의 다음 immutable revision을 만듭니다.

### Parameters

- `name` (string, required): 사람이 읽을 수 있는 skill 이름이며, 빈 이름은 거부됩니다.
- `instructions` (string, required): root procedure 본문이며 필수이고 UTF-8 인코딩 후 64 KiB로 제한됩니다.
- `slug` (string, optional, default: derived from name): 선택적 lowercase skill identifier이며 1–64자 slug contract를 따라야 합니다.
- `description` (string, optional, default: empty): Level 0 query discovery가 반환하는 선택적 discovery text입니다.
- `publish` (boolean, optional, default: true): publish intent입니다. personal scope는 직접 publish할 수 있지만 team scope는 proposed revision을 만듭니다.
- `components_json` (JSON array string, optional, default: []): type, logical_path, content 또는 artifact_ref, mime_type 및 metadata를 포함하는 선택적 component object입니다. 최대 50개이며 각 content body는 128 KiB로 제한됩니다.

### Returns

JSON CloudSkillResponseEnvelope를 반환합니다. object='cloud_skill', schema_version='xmemo.cloud_skill.v1', kind='root', render_status, warnings가 포함되며, data에는 skill_id, slug, name, description, revision_id, revision_number, instructions, canonical_hash 및 typed resources manifest가 들어 있습니다.

### Errors

- Authorization failure: MCP token에 memory:write가 없거나 caller가 확인된 personal/team scope에 쓸 수 없습니다.
- Validation failure: name 또는 instructions가 비어 있거나 slug가 유효하지 않거나 instruction body가 64 KiB를 초과합니다.
- Component validation failure: components_json이 JSON array가 아니거나 component path가 비어 있거나 absolute/traversal-like/reserved/duplicated 상태이거나 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를 로드하거나 pin한 resource를 읽습니다.
- [execute_cloud_skill](/docs/tools/execute-cloud-skill): 의도한 revision을 recall한 뒤 선언된 script component를 실행합니다.
- [remember](/docs/tools/remember): 재사용 가능한 procedure가 필요하지 않을 때 일반 durable memory를 사용합니다.

## 검토된 절차만 게시하기

지속 가능한 instructions와 선택적 typed components를 제공합니다. skill body에 credentials와 private material을 넣지 않습니다. 도구는 인증된 personal 또는 team scope에 절차를 저장합니다.