# recall_cloud_skill

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

- Canonical: https://docs.xmemo.dev/ko/docs/tools/recall-cloud-skill
- Locale: ko-KR
- Content-Locale: ko-KR
- Canonical-Content-Digest: a66c09970d11396c99dee1375dcc4f98f14752723e76286acb0b1929010be8fc
- Edition-Digest: 14426f424bed89b7b91f2fdcaaebbeeee6b1ba29f2d83aacf95187c795fe1d71
- Source-Revision: sha256:ede99f126c525b2202720b7cc58a07f4545e9b33620f111c105e26739e87783c

## Tool Reference: `recall_cloud_skill`

### Purpose

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

### Parameters

- `query` (string, optional, default: empty): Level 0 discovery text이며 skill_id와 slug가 비어 있을 때 사용됩니다.
- `skill_id` (string, optional, default: empty): root 또는 resource recall에 사용하는 안정적인 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가 들어 있습니다. 실패는 kind='error' 및 CloudSkillErrorPayload를 사용합니다.

### Errors

- 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가 없습니다.

### Examples

#### published skill 검색



```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을 사용합니다.

## 필요한 계층만 로드하기

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