save_cloud_skill

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

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

公開 MCP ツール

save_cloud_skill

用途

再利用可能なCloud Skillを作成または更新し、そのinstructionsとtyped componentsの次のimmutable revisionを生成します。

適用シーン

接続されたagentが既存のCloud Skill contractを通じてrecall・executeできる、永続的なprocedure、rule、SOPを公開する場合。
新しいpersonal skillを作成するか、team scopeのrevisionをteam review flowに提出する場合。
procedureに新しいversionと新しいcanonical hashが必要なため、既存のslugを置き換える場合。

非推奨シーン

一時的なchat、credentials、bearer tokens、private keys、raw secretsをskill instructionsやcomponent contentとして保存しないでください。
通常の永続factには使わないでください。rememberまたはSDK capture workflowを使います。
team publish intentがすぐliveになると考えないでください。team revisionはproposedとして保存され、直接publishされません。
instruction、component、component-countのlimitを超えないでください。validationは大きすぎる、または安全でないlogical pathを拒否します。

必須スコープ

MCP surfaceではmemory:writeが必要です。
advanced surfaceではpro minimum tierとしてcatalogueされ、認証済みpersonalまたはteam scopeがskillの保存先を決めます。

パラメーター

名前	型	説明
`name`	string · 必須	人が読めるskill nameです。空のnameは拒否されます。
`instructions`	string · 必須	root procedure bodyです。必須で、UTF-8エンコード後64 KiBに制限されます。
`slug`	string · デフォルト: derived from name	任意の小文字skill identifierで、1–64文字のslug contractに一致します。
`description`	string · デフォルト: empty	Level 0 query discoveryで返される任意のdiscovery textです。
`publish`	boolean · デフォルト: true	publish intentです。personal scopeは直接publishできますが、team scopeはproposed revisionを作成します。
`components_json`	JSON array string · デフォルト: []	type、logical_path、contentまたはartifact_ref、mime_type、metadataを持つ任意のcomponent objectです。最大50個で、各content bodyは128 KiBに制限されます。

返却スキーマ

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が含まれます。

使用例

personal procedureを公開する

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
})

エラー

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が必要です。

recall_cloud_skill — skillをdiscoveryし、root manifestを読み込み、保存後にpinしたresourceを読み取ります。
execute_cloud_skill — 意図したrevisionをrecallした後にだけ、宣言済みscript componentを実行します。
remember — 再利用可能なprocedureが不要なら通常の永続memoryを使います。

出典: Cloud Skills