Guía de Cloud Skills

Objetivo del usuario

Crea, revisa, publica y recupera habilidades de procedimiento reutilizables (como runbooks, listas de comprobación y procedimientos operativos estándar) en todos los agentes conectados sin necesidad de copiar y pegar manualmente, configurar repetidamente cada agente o sobrecargar la ventana de contexto.

Disponibilidad y requisitos previos

Cloud Skills se encuentra actualmente en Preview en la Memory Console en https://xmemo.dev/me#skills. Asegúrate de que tu entorno cumpla los siguientes requisitos antes de crear o recuperar skills:

• Habilitación de la característica: activo cuando procedural Cloud Skills está habilitado para tu cuenta.
• Selección de espacio de trabajo: el espacio personal (https://xmemo.dev/me#skills) almacena skills privadas. El espacio de equipo (https://xmemo.dev/me?space=<team_id>#skills) comparte skills entre los miembros autenticados del equipo con gobernanza basada en roles.
• Permisos de token del agente: la recuperación de agentes requiere el permiso skills:read o memory:read. La creación de skills y la publicación de revisiones requieren el permiso skills:write o memory:write.
• Perfiles de cliente compatibles: las herramientas MCP recall_cloud_skill y save_cloud_skill se exponen en los perfiles de cliente cursor-plugin y ordinary-full; las interfaces públicas y de chat genéricas no exponen herramientas de creación de skills directamente.

1. Navegar a Cloud Skills en la Memory Console

Abre la Memory Console y selecciona la sección Cloud Skills:

• Espacio personal: abre https://xmemo.dev/me#skills para gestionar tus runbooks de procedimiento personales.
• Espacio de equipo: abre https://xmemo.dev/me?space=<team_id>#skills para gestionar skills organizativas compartidas.
• Interfaz de la consola: el panel muestra la lista de skills, la barra de búsqueda ("Search skills by name, slug, or keywords...") y las acciones principales: "New Skill" e "Import Skill".

2. Crear una skill de procedimiento y componentes declarados

Haz clic en "New Skill" para abrir el modal de creación de skills. Configura los metadatos de la skill, las instrucciones raíz y los recursos de los componentes:

• Skill Name: introduce "Incident Response Checklist" (campo obligatorio).
• Slug: introduce un identificador en minúsculas "incident-response-checklist" (1–64 caracteres alfanuméricos o guiones).
• Description: introduce "Standard operating procedure for triaging and resolving high-severity production incidents.".
• Instructions: redacta directrices de procedimiento raíz en markdown (limitado a 64 KiB UTF-8).
• Components: añade el componente de plantilla templates/triage-template.md con el tipo template que contiene el cuestionario de incidentes.

# Incident Response Checklist

When a high-severity production alert triggers:
1. Identify the impacted service and declare an incident channel.
2. Verify service error rates and recent deployment events.
3. Complete the triage questionnaire at `templates/triage-template.md`.
4. Apply documented mitigation or initiate canary rollback.
5. Record timeline events and assign follow-up action items.

3. Revisar y publicar la revisión de la skill

Guarda la revisión de la skill y observa cómo se comporta la publicación en los espacios personal y de equipo:

• Publicación personal: en un espacio de trabajo personal, guardar con intención de publicación transfiere la revisión v1 directamente a "Published", haciéndola inmediatamente detectable para los agentes autorizados.
• Flujo de trabajo de revisión en equipo: en un espacio de trabajo de equipo, guardar crea la revisión v1 con el estado "proposed". Los miembros del equipo pueden revisar las instrucciones, inspeccionar diferencias de componentes y probar la ejecución antes de que un propietario o administrador del equipo publique la revisión.
• Preparación de borradores: si la intención de publicación no está marcada, la revisión permanece en estado "Draft" para edición y pruebas privadas sin exponerla a la detección de agentes.

4. Verificar la recuperación progresiva del agente

Los agentes conectados consultan y recuperan skills publicadas a petición en tres niveles progresivos para preservar los límites de contexto:

• Nivel 0 (Descubrimiento): el agente busca mediante una consulta de tarea y recibe descriptores ligeros sin las instrucciones completas.
• Nivel 1 (Instrucciones raíz): el agente recupera las instrucciones raíz y el manifiesto de componentes usando el slug de la skill.
• Nivel 2 (Recurso fijado): el agente recupera el componente de plantilla declarado proporcionando el revision_id exacto devuelto en el Nivel 1.

# Level 0: Discover relevant skills by task query
recall_cloud_skill(query="incident response")

# Level 1: Retrieve root instructions and component manifest
recall_cloud_skill(slug="incident-response-checklist")

# Level 2: Retrieve pinned component resource without resource tearing
recall_cloud_skill(
  slug="incident-response-checklist",
  revision_id="<revision-id-from-level-1>",
  resource="templates/triage-template.md",
)

5. Actualizar procedimiento y verificar la inmutabilidad de la revisión

Cuando los requisitos operativos cambien, actualiza la skill para crear una nueva revisión inmutable:

• Abrir detalles de la skill: en la consola, selecciona "Incident Response Checklist" y haz clic en "New Revision".
• Modificar instrucciones: añade un paso obligatorio de verificación canary antes de revertir.
• Guardar nueva revisión: guardar el contenido incrementa el contador de revisiones a v2, generando un nuevo revision_id inmutable y canonical_hash.
• Protección de fijación de revisiones: los flujos de trabajo de agentes en curso fijados a la revisión v1 continúan leyendo recursos de v1 sin fragmentación, mientras que las nuevas consultas de Nivel 1 resuelven automáticamente la revisión v2 publicada.

Resultado observable

La creación y publicación satisfactorias de una Cloud Skill genera cambios observables en la consola y las interfaces de los agentes:

• Insignia de estado de la consola: la tarjeta de la skill muestra la insignia "Published", la etiqueta de revisión activa (como v1 o v2) y el recuento de componentes.
• Explorador de recursos: la vista detallada muestra el componente declarado templates/triage-template.md con vista previa de sintaxis y acciones de copia.
• Envoltorio de recuperación del agente: el Nivel 1 devuelve una respuesta raíz tipada con instruction_body, revision_id y lista de recursos. El Nivel 2 devuelve el texto exacto del componente.
• Disponibilidad de exportación: desde la vista detallada, hacer clic en "Export" descarga un archivo ZIP Source Capsule que contiene SKILL.md, metadatos del manifiesto y componentes declarados.

A qué pueden acceder los agentes

Los agentes y usuarios humanos operan bajo estrictos límites de autenticación y capacidades:

• Perfiles de cliente: las herramientas MCP recall_cloud_skill y save_cloud_skill están expuestas contractualmente en los perfiles cursor-plugin y ordinary-full; los perfiles de cliente públicos y de chat genéricos no las exponen.
• Cumplimiento de permisos: los agentes se autentican con claves de API o tokens de OAuth con permisos skills:read o skills:write. Los tokens limitados a memoria personal no pueden inspeccionar skills de equipo a menos que estén explícitamente vinculados a ese equipo.
• Protección de borradores y propuestas: los agentes no pueden descubrir ni recuperar revisiones en borrador, revisiones propuestas en espera de revisión ni skills archivadas en el descubrimiento de consultas de Nivel 0.
• Orientación ejecutable por prompt: los agentes conectados interpretan las instrucciones de procedimiento directamente como contexto de prompt; las skills no ejecutan código automáticamente en el host.

Límites de uso compartido y ciclo de vida

Cloud Skills mantiene una separación clara de inquilinos entre runbooks personales y recursos colaborativos de equipo:

• Límites de espacio: las skills personales (/me#skills) son privadas para el creador. Las skills de equipo (?space=<team_id>#skills) se comparten con miembros autenticados del equipo.
• Aprobación de equipo: las revisiones de equipo requieren la revisión del propietario o administrador antes de pasar del estado "proposed" a "published".
• Archivado frente a eliminación: archivar una skill (DELETE /v1/skills/{skill_id}) inhabilita el descubrimiento de agentes y la oculta de la lista activa, conservando el historial de revisiones inmutable.
• Inmutabilidad de revisiones: las revisiones son instantáneas inmutables direccionadas por contenido; guardar actualizaciones crea una nueva revisión en lugar de sobrescribir los registros existentes.
• Banner de revisión de candidatos: la consola puede mostrar un banner de candidato con las acciones Promote y Dismiss cuando existe un candidato; los candidatos requieren revisión manual.

Recuperación ante fallos

Diagnostica y resuelve problemas comunes de Cloud Skills mediante los siguientes pasos de corrección:

• Error de recuperación de recurso (REVISION_PINNING_VIOLATION): las solicitudes de recursos de Nivel 2 requieren un revision_id explícito. Si se omite, el servidor rechaza la solicitud para evitar fragmentación de recursos. Solución: proporciona el revision_id devuelto en la respuesta de Nivel 1.
• Skill no encontrada (SKILL_NOT_FOUND): verifica que el slug coincida exactamente y que la consulta se ejecute en el espacio de trabajo correcto (Personal frente a Team ?space=<team_id>).
• Acceso denegado (403 Forbidden): comprueba que el token del agente incluya skills:read (para recuperar) o skills:write (para guardar), y que el usuario autenticado pertenezca al equipo de destino.
• La revisión de equipo permanece en estado propuesto: un agente que consulte una skill de equipo recibe la revisión actualmente publicada hasta que un propietario o administrador del equipo revise y publique la revisión propuesta.
• Entorno de ejecución no disponible (503): se devuelve si el subsistema Cloud Skills está deshabilitado o no está configurado en tu entorno de despliegue.

Referencia relacionada

Consulta documentación relacionada para conocer la arquitectura conceptual, los parámetros de herramientas y la colaboración en equipo:

• Conceptos de Cloud Skills: /docs/concepts/cloud-skills para arquitectura de tres niveles, modelos de componentes y fijación de revisiones.
• Referencia de recall_cloud_skill: /docs/tools/recall-cloud-skill para esquemas de parámetros y formatos de respuesta.
• Referencia de save_cloud_skill: /docs/tools/save-cloud-skill para parámetros de creación y formatos de carga de componentes.
• Memory Console: /docs/guides/memory-console para diseño de consola web, selección de espacio y configuraciones.
• Teams: /docs/capabilities/teams para colaboración en espacios de trabajo de equipo y permisos de roles.