# recall_cloud_skill

Discover Cloud Skills, load a root manifest, or fetch one resource from an explicitly pinned revision.

- Canonical: https://docs.xmemo.dev/docs/tools/recall-cloud-skill
- Locale: en-US
- Content-Locale: en-US
- Canonical-Content-Digest: a66c09970d11396c99dee1375dcc4f98f14752723e76286acb0b1929010be8fc
- Edition-Digest: 17ad6a68c5db21ea496a4e01442c42d9b295151d91e566fca0468d68daad4bf2
- Source-Revision: sha256:ede99f126c525b2202720b7cc58a07f4545e9b33620f111c105e26739e87783c

## Tool Reference: `recall_cloud_skill`

### Purpose

Progressively discover Cloud Skills, recall one root revision and manifest, or fetch one resource from an explicitly pinned revision.

### Parameters

- `query` (string, optional, default: empty): Level 0 discovery text; used when skill_id and slug are empty.
- `skill_id` (string, optional, default: empty): Stable Cloud Skill identity for root or resource recall.
- `slug` (string, optional, default: empty): Human-readable skill identity for root or resource recall.
- `revision_id` (string, optional, default: empty): Optional root revision pin; required for Level 2 resource recall.
- `resource` (string, optional, default: empty): Logical component path or component ID for Level 2 recall.

### Returns

A JSON CloudSkillResponseEnvelope: Level 0 kind='descriptor' with descriptor data; Level 1 kind='root' with instructions, revision metadata, canonical_hash, warnings, and resources; Level 2 kind='resource' with the pinned component content/hash; failures use kind='error' and CloudSkillErrorPayload.

### Errors

- ACCESS_DENIED: the requested skill ID does not belong to the authenticated personal/team scope.
- SKILL_NOT_FOUND or SKILL_ARCHIVED: no active skill matches the supplied identity.
- REVISION_NOT_FOUND: the requested or published revision cannot be resolved for the skill.
- REVISION_PINNING_VIOLATION: a Level 2 resource request omitted revision_id.
- RESOURCE_NOT_FOUND: the logical resource path or component ID is not present in the pinned revision.

### Examples

#### Discover a published skill



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

#### Load a pinned 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): Create the durable skill or publish its next revision.
- [execute_cloud_skill](/docs/tools/execute-cloud-skill): Execute a recalled script component through the sandbox.
- [recall_context](/docs/tools/recall-context): Use memory context retrieval when the target is agent memory rather than a Cloud Skill resource.

## Load only the layer you need

Start with query discovery, then use the returned skill or revision identifiers for root and resource recall. Level 2 resource reads require an explicit revision_id.