# Guía de Cloud Skills Crea, revisa, publica y recupera progresivamente habilidades de procedimiento reutilizables en todos los agentes conectados. - Canonical: https://docs.xmemo.dev/es/docs/guides/cloud-skills - Locale: es-ES - Content-Locale: es-ES - Canonical-Content-Digest: bff532eedc870bca9f5f7c7413891d20ab5e233fb9fdcccd4e6d38b38aba2d9e - Edition-Digest: 8d8449df7df53194a4a7a594aba70c32c0c2f685cc2c0da6a30d3f164c7369c2 - Source-Revision: sha256:2ed8d0fb7f3432c8695de21a099b7ce6fd715f59effbe3a2bb60822a68e1af34 ## 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=#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=#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. ```markdown # 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. ```text # 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="", 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=#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=). - 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. ## Usuario de ChatGPT Dale a ChatGPT acceso duradero a tus preferencias de XMemo, datos de proyecto, decisiones y TODOs sin pegar fichas bearer en un chat. Conecte el servidor XMemo MCP alojado a través de la aplicación ChatGPT/OpenAI OAuth flow, luego apruebe la subvención de memoria:read y memoria:write para su cuenta XMemo. Guarde una nota de preferencia sintética o de proyecto, inicie un nuevo chat y luego pida a ChatGPT que la recuerde a través de XMemo antes de continuar el trabajo. Si OAuth falla o las herramientas no aparecen, salir del servidor MCP en la aplicación host, volver a conectar la URL del servidor XMemo y volver a probar antes de crear tokens directos. ## Copiloto / Codex desarrollador Lleve decisiones de repo, convenciones de codificación, notas de corrección de errores e historial de tareas entre los agentes IDE y CLI. Use OAuth para VS Code / GitHub Copilot y Gemini CLI cuando esté disponible. Para Copilot CLI, Codex, Cursor u otros clientes MCP directos, mantenga XMEMO_KEY en el entorno local o en el almacén de secretos y establezca un XMEMO_AGENT_INSTANCE_ID estable. Grabe una decisión de base de código o corrección de errores, y luego pida al siguiente agente IDE o CLI que recuerde el contexto XMemo relevante antes de editarlo. Si las memorias están vacías, verifique la ruta de configuración MCP seleccionada, la variable de entorno XMEMO_KEY para clientes directos y cualquier credencial OAuth rancio en la aplicación host. ## Equipo / propietario del piloto de la empresa Evalúe la memoria compartida con controles de cuenta, atribución de origen, flujos de trabajo export/delete y pruebas de configuración seguras para los revisores. Cree o introduzca el espacio de trabajo protegido de XMemo, invite a usuarios aprobados, luego conecte a cada cliente a través de OAuth o una credencial directa con alcance de acuerdo con las insignias de preparación. Haga que un miembro piloto guarde una memoria sintética del equipo, confirme la atribución de origen en XMemo, luego revise delete/export y las rutas de soporte. Si un miembro no puede conectarse, compruebe los permisos de rol, la aprobación de OAuth, el estado de preparación del cliente y la orientación de soporte antes de emitir un nuevo token. ## Operador de agente autónomo Deje que los agentes sin cabeza o programados registren el progreso, recuperen decisiones previas y mantengan una identidad estable de instancia no secreta. Obtener /api/v1/mcp/config/autonomous-agent. Preferir auth_modes.oauth cuando el runner soporta OAuth + cabeceras personalizadas; utilice auth_modes.xmemo_key con XMEMO_KEY de una tienda secreta sólo para runners totalmente sin cabeza. Ejecute una tarea sintética que escriba el progreso a XMemo, reinicie el runner y confirme que recuerda que el progreso usando el mismo XMEMO_AGENT_INSTANCE_ID. Si la atribución cambia o recuerda dividida entre instancias, persistir XMEMO_AGENT_INSTANCE_ID fuera de git y verificar que el runner no lo esté regenerando en cada inicio.