recall_cloud_skill

필요한 계층만 로드하기

query discovery로 시작한 뒤 반환된 skill 또는 revision identifier를 사용해 root 및 resource recall을 수행합니다. Level 2 resource read에는 명시적 revision_id가 필요합니다.

공개 MCP 도구

recall_cloud_skill

목적

Cloud Skill을 단계적으로 검색하고 하나의 root revision 및 manifest를 recall하거나, 명시적으로 pin한 revision에서 하나의 resource를 가져옵니다.

사용 시점

agent가 name, slug 또는 description term으로 재사용 가능한 published skill을 찾으려면 query로 시작합니다.
component이 필요한지 판단하기 전에 root instructions와 resource manifest를 로드합니다.
Level 1에서 선택한 revision에서 하나의 정확한 reference, example, template, document, artifact 또는 script를 가져옵니다.

사용하지 않을 시점

root recall에서 반환된 revision_id 없이 Level 2 resource request를 보내지 않습니다. service가 pin되지 않은 resource read를 거부합니다.
Level 0의 descriptor를 skill instructions로 취급하지 않습니다. descriptor는 discovery metadata일 뿐입니다.
script를 실행하는 데 사용하지 않습니다. pin한 revision과 script path를 확인한 뒤 execute_cloud_skill을 사용합니다.
archived skill이나 인증된 personal/team scope 밖의 skill이 반환된다고 기대하지 않습니다.

필수 스코프

MCP surface에는 memory:read가 필요합니다.
advanced tool은 인증된 personal 또는 team scope 안에서 skill을 확인하며 이 경계를 넓히지 않습니다.

매개변수

이름	타입	설명
`query`	string · 기본값: empty	Level 0 discovery text이며 skill_id와 slug가 비어 있을 때 사용됩니다.
`skill_id`	string · 기본값: empty	root 또는 resource recall에 사용하는 안정적인 Cloud Skill identity입니다.
`slug`	string · 기본값: empty	root 또는 resource recall에 사용하는 사람이 읽을 수 있는 skill identity입니다.
`revision_id`	string · 기본값: empty	선택적 root revision pin이며 Level 2 resource recall에는 필수입니다.
`resource`	string · 기본값: empty	Level 2 recall에 사용하는 logical component path 또는 component ID입니다.

반환 스키마

JSON CloudSkillResponseEnvelope를 반환합니다. Level 0 kind='descriptor'에는 descriptor data가, Level 1 kind='root'에는 instructions, revision metadata, canonical_hash, warnings 및 resources가, Level 2 kind='resource'에는 pin한 component content/hash가 들어 있습니다. 실패는 kind='error' 및 CloudSkillErrorPayload를 사용합니다.

예제

published skill 검색

recall_cloud_skill({ query: "deployment verification" })

pin한 script resource 로드

recall_cloud_skill({
  slug: "deployment-procedure",
  revision_id: "revision-id-from-root-recall",
  resource: "scripts/check.py"
})

오류

ACCESS_DENIED: 요청한 skill ID가 인증된 personal/team scope에 속하지 않습니다.
SKILL_NOT_FOUND or SKILL_ARCHIVED: 제공된 identity와 일치하는 active skill이 없습니다.
REVISION_NOT_FOUND: 요청한 revision 또는 published revision을 skill에 대해 확인할 수 없습니다.
REVISION_PINNING_VIOLATION: Level 2 resource request에 revision_id가 없습니다.
RESOURCE_NOT_FOUND: pin한 revision에 logical resource path 또는 component ID가 없습니다.

save_cloud_skill — durable skill을 생성하거나 다음 revision을 publish합니다.
execute_cloud_skill — recall한 script component를 sandbox를 통해 실행합니다.
recall_context — 대상이 Cloud Skill resource가 아니라 agent memory일 때 memory context retrieval을 사용합니다.

출처: Cloud Skills