Publica solo un procedimiento revisado
Proporciona instrucciones duraderas y componentes tipados opcionales. Mantén las credenciales y el material privado fuera del cuerpo de la skill; la herramienta guarda el procedimiento en el ámbito personal o de equipo autenticado.
Herramienta MCP pública
save_cloud_skill
Propósito
Crea o actualiza un Cloud Skill reutilizable y produce la siguiente revisión inmutable de sus instrucciones y componentes tipados.
Cuándo usar
- Publica un procedimiento, regla o SOP duradero que los agentes conectados puedan recuperar y ejecutar mediante el contrato existente de Cloud Skill.
- Crea una skill personal nueva o envía una revisión de ámbito de equipo al flujo de revisión del equipo.
- Reemplaza un slug existente cuando el procedimiento necesite una nueva versión con un nuevo hash canónico.
Cuándo NO usar
- No guardes chat transitorio, credenciales, bearer tokens, claves privadas ni secretos sin procesar como instrucciones de la skill o contenido de componentes.
- No la uses para un hecho durable ordinario; usa remember o el flujo de captura del SDK.
- No supongas que la intención de publicación del equipo estará activa de inmediato: las revisiones de equipo se proponen en lugar de publicarse directamente.
- No superes los límites de instrucciones, componentes o cantidad de componentes; la validación rechaza rutas lógicas demasiado grandes o inseguras.
Ámbito requerido
- La superficie MCP requiere memory:write.
- La herramienta está catalogada en la superficie avanzada con un nivel mínimo pro; el ámbito personal o de equipo autenticado determina dónde se almacena la skill.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
name | string · obligatorio | Nombre legible de la skill; los nombres vacíos se rechazan. |
instructions | string · obligatorio | Cuerpo del procedimiento raíz; es obligatorio y está limitado a 64 KiB después de la codificación UTF-8. |
slug | string · predeterminado: derived from name | Identificador opcional de la skill en minúsculas que cumple el contrato de slug de 1–64 caracteres. |
description | string · predeterminado: empty | Texto opcional de descubrimiento devuelto por el descubrimiento de consultas de Level 0. |
publish | boolean · predeterminado: true | Intención de publicación; el ámbito personal puede publicar directamente, mientras que el ámbito de equipo crea una revisión propuesta. |
components_json | JSON array string · predeterminado: [] | Objetos de componentes opcionales con type, logical_path, content o artifact_ref, mime_type y metadata; como máximo 50, y cada cuerpo de content está limitado a 128 KiB. |
Esquema de retorno
Un CloudSkillResponseEnvelope JSON con object='cloud_skill', schema_version='xmemo.cloud_skill.v1', kind='root', render_status, warnings y data que contiene skill_id, slug, name, description, revision_id, revision_number, instructions, canonical_hash y un manifiesto de recursos tipados.
Ejemplos
save_cloud_skill({
name: "deployment-procedure",
instructions: "Check the release, run the smoke test, and report the result.",
slug: "deployment-procedure",
description: "A bounded deployment verification procedure",
publish: true
})Errores
- Authorization failure: el token MCP carece de memory:write o el caller no puede escribir en el ámbito personal/equipo resuelto.
- Validation failure: name o instructions está vacío, el slug no es válido o el cuerpo de instrucciones supera 64 KiB.
- Component validation failure: components_json no es un array JSON, una ruta de componente está vacía, es absoluta, similar a traversal, reservada o duplicada, el type no es válido o un componente supera 128 KiB.
- Scope lifecycle: la publicación personal es directa; la publicación de equipo se almacena como propuesta y requiere el flujo de revisión del equipo.
Herramientas relacionadas
- recall_cloud_skill — Descubre la skill, carga su manifiesto raíz o lee un recurso fijado después de guardarla.
- execute_cloud_skill — Ejecuta un componente de script declarado solo después de recuperar la revisión prevista.
- remember — Usa la memoria durable ordinaria cuando no se necesite un procedimiento reutilizable.
Fuente: Cloud Skills