ReferenciaHabilidadesActualizaciones y ciclo de vida de la Skill

Skill

Actualizaciones y ciclo de vida de la Skill

Inspecciona versiones, actualiza versiones publicadas, gestiona copias de seguridad y elimina de forma segura el entorno de ejecución local independiente de la Skill.

Versiones diferenciadas de la Skill y de la CLI

El entorno de ejecución independiente de la Skill y la CLI de XMemo son paquetes independientes con números de versión y ciclos de lanzamiento separados. La actualización de uno no modifica automáticamente el otro.

  • Paquete de Skill independiente: versión 1.1.35 (@xmemo/skill@1.1.35), inspeccionable mediante node scripts/xmemo-skill.mjs --version o doctor.
  • Paquete de la CLI de XMemo: versión 0.4.x / 1.x (@xmemo/client@0.4.187), inspeccionable mediante xmemo --version.
  • Actualizaciones independientes: actualizar @xmemo/client mediante npm actualiza el orquestador de la CLI, pero no altera los directorios de skills instaladas existentes hasta que se ejecute xmemo skill update.
  • Subresource Integrity (SRI): la CLI verifica los paquetes tarball usando sha512 SRI antes de extraer archivos en los directorios de skills del agente.
# Inspect standalone Skill version:
node scripts/xmemo-skill.mjs --version

# Inspect XMemo CLI version:
xmemo --version

# Inspect detailed runtime health and discovery status:
node scripts/xmemo-skill.mjs doctor

Comandos de la CLI para el ciclo de vida de la skill

La CLI de XMemo proporciona comandos específicos para inspeccionar el estado de la instalación, instalar en clientes de agente, actualizar a versiones más recientes y eliminar skills de forma segura.

  • Estado: xmemo skill status [--client <id>|--all] [--json] inspecciona las skills instaladas e informa de la versión, el ID de cliente y la ruta de destino.
  • Instalación: xmemo skill install [--client <id>|--all] [--project] [--global] [--dir <path>] [--dry-run] [--yes] [--force] [--json].
  • Actualización: xmemo skill update [--client <id>|--all] [--dry-run] [--yes] [--json] actualiza las skills instaladas a la versión fijada más reciente.
  • Eliminación: xmemo skill remove --client <id> [--project] [--yes] [--json] elimina de forma segura las carpetas de skill verificadas.
# Check status across all detected clients:
xmemo skill status --all

# Update an installed skill with preview:
xmemo skill update --client codex --dry-run
xmemo skill update --client codex --yes

# Install to a specific client:
xmemo skill install --client claude-code --yes

Gestión de instalaciones existentes, copias de seguridad y recuperación

Para evitar sobrescrituras accidentales o la pérdida de personalizaciones, el instalador rehúsa sobrescribir un directorio existente sin confirmación explícita y crea copias de seguridad de forma automática.

  • Rechazo de sobrescritura: volver a ejecutar la instalación en un directorio de skill existente se detiene e informa de una instalación existente a menos que se pase --force (o XMEMO_SKILL_FORCE=1).
  • Ubicación automatizada de copias de seguridad: cuando --force o skill update reemplaza una instalación, la versión anterior se traslada a ~/.xmemo/backups/skills/<client_id>/<name>-<timestamp> (o a ~/.xmemo/backups/skills/custom/<basename>-<timestamp> para directorios personalizados).
  • Aislamiento de la carga del agente: las copias de seguridad residen de forma segura en ~/.xmemo/backups/, fuera de las rutas de búsqueda de skills activas del agente, evitando registros duplicados de herramientas.
  • Recuperación: para revertir una actualización, restaura el directorio de copia de seguridad preservado desde ~/.xmemo/backups/skills/<client_id>/ en la carpeta de skills activa del agente.
# Force re-install with automatic backup creation:
xmemo skill install --client codex --force --yes

# Inspect preserved backups:
ls -la ~/.xmemo/backups/skills/codex/

Qué deja atrás la eliminación

Eliminar una skill es una operación local del sistema de archivos que desvincula el directorio de la skill. No borra tus credenciales, la configuración local ni los recuerdos remotos.

  • Directorio local de la skill eliminado: xmemo skill remove elimina únicamente el directorio verificado xmemo-memory y rechaza carpetas ajenas.
  • Las credenciales permanecen intactas: ~/.xmemo/skill-credentials.json y la variable de entorno XMEMO_KEY permanecen intactos.
  • La configuración permanece intacta: los ajustes locales en ~/.xmemo/ se mantienen intactos.
  • Los recuerdos remotos permanecen intactos: los recuerdos almacenados, los elementos de Knowledge y las tareas TODO en xmemo.dev no se eliminan al quitar la skill.
  • Limpieza completa de credenciales: ejecuta node scripts/xmemo-skill.mjs logout antes de la eliminación para revocar el token de sesión activo, o elimina manualmente ~/.xmemo/skill-credentials.json.
  • Purga de recuerdos: los recuerdos remotos siguen accesibles hasta que se marquen como eliminados mediante node scripts/xmemo-skill.mjs forget --id <id> --confirm o se purguen a través de Memory Console.
# Step 1: Revoke active session credentials (optional):
node scripts/xmemo-skill.mjs logout

# Step 2: Remove the installed skill directory:
xmemo skill remove --client codex --yes

Actualizaciones y ciclo de vida de la Skill

Las Skills son la vía de instrucciones y comandos para agentes que no montan directamente un servidor MCP alojado.

Abrir XMemo Skills

Fuente: XMemo Skills