save_cloud_skill

검토된 절차만 게시하기

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

공개 MCP 도구

save_cloud_skill

목적

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

사용 시점

연결된 agent가 기존 Cloud Skill contract를 통해 recall하고 실행할 수 있는 지속 가능한 procedure, rule 또는 SOP를 게시합니다.
새 personal skill을 만들거나 team scope revision을 team review flow에 제출합니다.
procedure에 새 canonical hash가 필요할 때 기존 slug를 새 version으로 교체합니다.

사용하지 않을 시점

transient chat, credentials, bearer token, private key 또는 raw secret을 skill instructions나 component content에 저장하지 않습니다.
ordinary durable fact에는 사용하지 않습니다. 대신 remember 또는 SDK capture workflow를 사용합니다.
team publish intent가 즉시 live가 된다고 가정하지 않습니다. team revision은 proposed 상태이며 team review flow가 필요합니다.
instruction, component 또는 component-count limit을 초과하지 않습니다. validation은 크기가 큰 logical path나 안전하지 않은 logical path를 거부합니다.

필수 스코프

MCP surface에는 memory:write가 필요합니다.
이 도구는 advanced surface에서 pro minimum tier로 분류되며, 인증된 personal 또는 team scope가 skill 저장 위치를 결정합니다.

매개변수

이름	타입	설명
`name`	string · 필수	사람이 읽을 수 있는 skill 이름이며, 빈 이름은 거부됩니다.
`instructions`	string · 필수	root procedure 본문이며 필수이고 UTF-8 인코딩 후 64 KiB로 제한됩니다.
`slug`	string · 기본값: derived from name	선택적 lowercase 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가 없거나 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가 필요합니다.

recall_cloud_skill — 저장한 뒤 skill을 검색하고 root manifest를 로드하거나 pin한 resource를 읽습니다.
execute_cloud_skill — 의도한 revision을 recall한 뒤 선언된 script component를 실행합니다.
remember — 재사용 가능한 procedure가 필요하지 않을 때 일반 durable memory를 사용합니다.

출처: Cloud Skills