# save_cloud_skill

再利用可能なCloud Skillを保存または更新し、次のversioned revisionを作成します。

- Canonical: https://docs.xmemo.dev/ja/docs/tools/save-cloud-skill
- Locale: ja-JP
- Content-Locale: ja-JP
- Canonical-Content-Digest: 04d9414473b38ac4dc5cc2f5060d7c6b004a36ed2d57cf20fbda34994c123a3f
- Edition-Digest: f789e4394a771f951d1b42ac5501807bb09adb33aea5d41e9dfa86bc4dc1b7d3
- Source-Revision: sha256:718059b6bf8760a2fbcf899877706dcb1219cbf46ea3053aecd788d1274ab789

## Tool Reference: `save_cloud_skill`

### Purpose

再利用可能なCloud Skillを作成または更新し、そのinstructionsとtyped componentsの次のimmutable 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): 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がないか、解決されたpersonal/team scopeへcallerがwriteできません。
- Validation failure: nameまたはinstructionsが空、slugが無効、またはinstruction bodyが64 KiBを超えています。
- Component validation failure: components_jsonがJSON arrayでない、component pathが空・absolute・traversal-like・reserved・重複、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をdiscoveryし、root manifestを読み込み、保存後にpinしたresourceを読み取ります。
- [execute_cloud_skill](/docs/tools/execute-cloud-skill): 意図したrevisionをrecallした後にだけ、宣言済みscript componentを実行します。
- [remember](/docs/tools/remember): 再利用可能なprocedureが不要なら通常の永続memoryを使います。

## review済みの手順だけを公開する

永続的なinstructionsと、必要に応じてtyped componentsを渡します。credentialsやprivate materialをskill bodyに含めず、toolは認証済みのpersonalまたはteam scopeに手順を保存します。