recall_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.

Ferramenta MCP pública

recall_cloud_skill

Finalidade

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

Quando usar

Comece com uma query quando o agente precisar descobrir um skill publicado e reutilizável por nome, slug ou termos da descrição.
Carregue as instruções raiz e o manifesto de recursos antes de decidir se um componente é necessário.
Busque uma referência, exemplo, template, documento, artefato ou script exato na revisão selecionada no nível 1.

Quando NÃO usar

Não use uma solicitação de recurso de nível 2 sem o revision_id retornado pela recuperação raiz; o serviço rejeita leituras de recursos sem fixação.
Não trate um descritor do nível 0 como as instruções do skill; ele contém somente metadados de descoberta.
Não use para executar um script; use execute_cloud_skill depois de verificar a revisão fixada e o caminho do script.
Não espere que skills arquivados ou fora do escopo pessoal/de equipe autenticado sejam retornados.

Escopo necessário

memory:read é obrigatório na superfície MCP.
A ferramenta avançada resolve skills dentro do escopo pessoal ou de equipe autenticado e não amplia esse limite.

Parâmetros

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

Esquema de retorno

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.

Exemplos

Descubra um skill publicado

recall_cloud_skill({ query: "deployment verification" })

Carregue um recurso de script fixado

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

Erros

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.

save_cloud_skill — Crie o skill duradouro ou publique sua próxima revisão.
execute_cloud_skill — Execute um componente de script recuperado pelo sandbox.
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.

Origem: Cloud Skills