リファレンスMCP ツールrecall_cloud_skill

Tool Reference

recall_cloud_skill

Cloud Skillsを検索し、root manifestを読み込むか、明示的にpinしたrevisionから1つのresourceを取得します。

必要なlayerだけを読み込む

まずqueryでdiscoveryを行い、返されたskillまたはrevisionのidentifierを使ってrootとresourceをrecallします。Level 2のresource readには明示的なrevision_idが必要です。

公開 MCP ツール

recall_cloud_skill

用途

Cloud Skillsを段階的にdiscoveryし、1つのroot revisionとmanifestをrecallするか、明示的にpinしたrevisionから1つのresourceを取得します。

適用シーン

  • agentがname、slug、description termから再利用可能なpublished skillを探す必要がある場合は、queryから始めます。
  • componentが必要か判断する前に、root instructionsとresource manifestを読み込みます。
  • Level 1で選択したrevisionから、exactなreference、example、template、document、artifact、scriptを1つ取得する場合。

非推奨シーン

  • root recallから返されたrevision_idなしにLevel 2 resource requestを使わないでください。serviceはpinされていないresource readを拒否します。
  • Level 0のdescriptorをskill instructionsとして扱わないでください。これはdiscovery metadataにすぎません。
  • scriptの実行には使わないでください。pinned revisionとscript pathを確認してからexecute_cloud_skillを使います。
  • archived skillや、認証済みpersonal/team scope外のskillが返されることを期待しないでください。

必須スコープ

  • MCP surfaceではmemory:readが必要です。
  • advanced toolは認証済みpersonalまたはteam scope内でskillを解決し、そのboundaryを広げません。

パラメーター

名前型説明
querystring · デフォルト: emptyLevel 0 discovery textです。skill_idとslugが空のときに使います。
skill_idstring · デフォルト: emptyrootまたはresource recallに使うstableなCloud Skill identityです。
slugstring · デフォルト: emptyrootまたはresource recallに使う人が読めるskill identityです。
revision_idstring · デフォルト: empty任意のroot revision pinです。Level 2 resource recallでは必須です。
resourcestring · デフォルト: emptyLevel 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を返し、failureはkind='error'とCloudSkillErrorPayloadを使います。

使用例

published skillをdiscoveryする
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: requested skill IDが認証済みpersonal/team scopeに属していません。
  • SKILL_NOT_FOUNDまたはSKILL_ARCHIVED: 指定されたidentityに一致するactive skillがありません。
  • REVISION_NOT_FOUND: requestedまたはpublished revisionをskillに対して解決できません。
  • REVISION_PINNING_VIOLATION: Level 2 resource requestにrevision_idがありません。
  • RESOURCE_NOT_FOUND: logical resource pathまたはcomponent IDがpinned revisionに存在しません。
  • 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