# recall_cloud_skill

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

- Canonical: https://docs.xmemo.dev/ja/docs/tools/recall-cloud-skill
- Locale: ja-JP
- Content-Locale: ja-JP
- Canonical-Content-Digest: a66c09970d11396c99dee1375dcc4f98f14752723e76286acb0b1929010be8fc
- Edition-Digest: 19beadaf806cc21c2ade6dd79a0e500b2c3c2432d57bbd29be35c67d17998b83
- Source-Revision: sha256:ede99f126c525b2202720b7cc58a07f4545e9b33620f111c105e26739e87783c

## Tool Reference: `recall_cloud_skill`

### Purpose

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

### Parameters

- `query` (string, optional, default: empty): Level 0 discovery textです。skill_idとslugが空のときに使います。
- `skill_id` (string, optional, default: empty): rootまたはresource recallに使うstableなCloud Skill identityです。
- `slug` (string, optional, default: empty): rootまたはresource recallに使う人が読めるskill identityです。
- `revision_id` (string, optional, default: empty): 任意のroot revision pinです。Level 2 resource recallでは必須です。
- `resource` (string, optional, default: empty): Level 2 recallに使うlogical component pathまたはcomponent IDです。

### Returns

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を使います。

### Errors

- 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に存在しません。

### Examples

#### published skillをdiscoveryする



```typescript
recall_cloud_skill({ query: "deployment verification" })
```

#### pinしたscript resourceを読み込む



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

### Related Tools

- [save_cloud_skill](/docs/tools/save-cloud-skill): durable skillを作成するか、次のrevisionをpublishします。
- [execute_cloud_skill](/docs/tools/execute-cloud-skill): recallしたscript componentをsandboxで実行します。
- [recall_context](/docs/tools/recall-context): 対象がCloud Skill resourceではなくagent memoryの場合はmemory context retrievalを使います。

## 必要なlayerだけを読み込む

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