# recall_cloud_skill

Descubra Cloud Skills, carregue um manifesto raiz ou busque um recurso em uma revisão explicitamente fixada.

- Canonical: https://docs.xmemo.dev/pt-br/docs/tools/recall-cloud-skill
- Locale: pt-BR
- Content-Locale: pt-BR
- Canonical-Content-Digest: a66c09970d11396c99dee1375dcc4f98f14752723e76286acb0b1929010be8fc
- Edition-Digest: 5ae252c0b08fc55d96dbc494ea00c69cb7840ef121bf922a91d5113d7b9f41a1
- Source-Revision: sha256:ede99f126c525b2202720b7cc58a07f4545e9b33620f111c105e26739e87783c

## Tool Reference: `recall_cloud_skill`

### Purpose

Descubra Cloud Skills progressivamente, recupere uma revisão raiz e seu manifesto ou busque um recurso de uma revisão explicitamente fixada.

### Parameters

- `query` (string, optional, default: empty): Texto de descoberta de nível 0; usado quando skill_id e slug estão vazios.
- `skill_id` (string, optional, default: empty): Identidade estável do Cloud Skill para recuperação de raiz ou recurso.
- `slug` (string, optional, default: empty): Identidade legível do skill para recuperação de raiz ou recurso.
- `revision_id` (string, optional, default: empty): Fixação opcional da revisão raiz; obrigatória para recuperação de recurso de nível 2.
- `resource` (string, optional, default: empty): Caminho lógico ou ID do componente para recuperação de nível 2.

### Returns

Um JSON CloudSkillResponseEnvelope: nível 0 com kind='descriptor' e dados do descritor; nível 1 com kind='root', instruções, metadados da revisão, canonical_hash, warnings e resources; nível 2 com kind='resource' e conteúdo/hash do componente fixado; falhas usam kind='error' e CloudSkillErrorPayload.

### Errors

- ACCESS_DENIED: o ID do skill solicitado não pertence ao escopo pessoal/equipe autenticado.
- SKILL_NOT_FOUND ou SKILL_ARCHIVED: nenhum skill ativo corresponde à identidade fornecida.
- REVISION_NOT_FOUND: a revisão solicitada ou publicada não pode ser resolvida para o skill.
- REVISION_PINNING_VIOLATION: uma solicitação de recurso de nível 2 omitiu revision_id.
- RESOURCE_NOT_FOUND: o caminho lógico do recurso ou ID do componente não está presente na revisão fixada.

### Examples

#### Descubra um skill publicado



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

#### Carregue um recurso de script fixado



```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): Crie o skill duradouro ou publique sua próxima revisão.
- [execute_cloud_skill](/docs/tools/execute-cloud-skill): Execute um componente de script recuperado pelo sandbox.
- [recall_context](/docs/tools/recall-context): Use recuperação de contexto da memória quando o alvo for memória do agente, não um recurso de Cloud Skill.

## Carregue somente a camada necessária

Comece pela descoberta com query e use os identificadores de skill ou revisão retornados para recuperar a raiz e os recursos. Leituras de recursos de nível 2 exigem um revision_id explícito.