Carga solo la capa que necesitas
Comienza con la búsqueda mediante query y usa después los identificadores de skill o revisión devueltos para recuperar la raíz y los recursos. Las lecturas de recursos de Level 2 requieren un revision_id explícito.
Herramienta MCP pública
recall_cloud_skill
Propósito
Descubre progresivamente Cloud Skills, recupera una revisión raíz y su manifiesto, o recupera un recurso de una revisión fijada explícitamente.
Cuándo usar
- Empieza con una consulta cuando el agente necesite descubrir una skill publicada y reutilizable por nombre, slug o términos de descripción.
- Carga las instrucciones raíz y el manifiesto de recursos antes de decidir si hace falta un componente.
- Recupera una referencia, ejemplo, plantilla, documento, artefacto o script exacto de la revisión seleccionada en Level 1.
Cuándo NO usar
- No uses una solicitud de recursos de Level 2 sin el revision_id devuelto por la recuperación raíz; el servicio rechaza las lecturas de recursos no fijadas.
- No trates un descriptor de Level 0 como las instrucciones de la skill; solo contiene metadatos de descubrimiento.
- No la uses para ejecutar un script; usa execute_cloud_skill después de verificar la revisión fijada y la ruta del script.
- No esperes que se devuelvan skills archivadas o skills fuera del ámbito personal/equipo autenticado.
Ámbito requerido
- La superficie MCP requiere memory:read.
- La herramienta avanzada resuelve las skills dentro del ámbito personal o de equipo autenticado y no amplía ese límite.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
query | string · predeterminado: empty | Texto de descubrimiento de Level 0; se usa cuando skill_id y slug están vacíos. |
skill_id | string · predeterminado: empty | Identidad estable de Cloud Skill para recuperar la raíz o un recurso. |
slug | string · predeterminado: empty | Identidad legible de la skill para recuperar la raíz o un recurso. |
revision_id | string · predeterminado: empty | Fijación opcional de la revisión raíz; es obligatoria para recuperar recursos de Level 2. |
resource | string · predeterminado: empty | Ruta lógica del componente o ID del componente para la recuperación de Level 2. |
Esquema de retorno
Un CloudSkillResponseEnvelope JSON: Level 0 devuelve kind='descriptor' con datos del descriptor; Level 1 devuelve kind='root' con instrucciones, metadatos de revisión, canonical_hash, warnings y recursos; Level 2 devuelve kind='resource' con el contenido/hash del componente fijado; los fallos usan kind='error' y CloudSkillErrorPayload.
Ejemplos
recall_cloud_skill({ query: "deployment verification" })recall_cloud_skill({
slug: "deployment-procedure",
revision_id: "revision-id-from-root-recall",
resource: "scripts/check.py"
})Errores
- ACCESS_DENIED: el ID de skill solicitado no pertenece al ámbito personal/equipo autenticado.
- SKILL_NOT_FOUND or SKILL_ARCHIVED: ninguna skill activa coincide con la identidad proporcionada.
- REVISION_NOT_FOUND: no se puede resolver la revisión solicitada o publicada de la skill.
- REVISION_PINNING_VIOLATION: una solicitud de recursos de Level 2 omitió revision_id.
- RESOURCE_NOT_FOUND: la ruta lógica del recurso o el ID del componente no está presente en la revisión fijada.
Herramientas relacionadas
- save_cloud_skill — Crea la skill durable o publica su siguiente revisión.
- execute_cloud_skill — Ejecuta un componente de script recuperado mediante el sandbox.
- recall_context — Usa la recuperación de contexto de memoria cuando el objetivo es la memoria del agente y no un recurso de Cloud Skill.
Fuente: Cloud Skills