MemoryLake
Volver a todos los artículos
Tutorial20 de noviembre de 2026·10 min de lectura

Cómo migrar sus Claude Skills a Codex sin perder el contexto (2026)

Durante el último año, ha creado un puñado de skills en Claude. Una formatea las notas de lanzamiento como le gusta a su equipo. Otra convierte la transcripción de una reunión en puntos de acción. Una más verifica un pull request contra una lista de reglas internas. Algunas viven en la configuración de Claude, subidas como archivos ZIP. Otras residen en ~/.claude/skills porque las escribió para Claude Code. Ahora está usando más Codex y quiere las mismas skills allí.

La buena noticia es que ambas herramientas se basan en el mismo formato. La documentación de Codex de OpenAI dice: "Las skills se basan en el estándar abierto de skills para agentes". La documentación de Anthropic describe las Claude skills de la misma manera, como carpetas de instrucciones, scripts y recursos con un archivo SKILL.md en el centro.

El trabajo está en los detalles: dónde vive cada tipo de Claude skill, cuáles detecta el importador de Codex, qué campos de frontmatter lee Codex y qué funciones de Claude Code no se transfieren. Esta guía cubre todo esto, además de cómo mantener los motivos detrás de cada skill cuando los archivos se mueven.

Qué es una skill en cada lado

El centro de ayuda de Anthropic define una skill en una línea: "Las skills son carpetas de instrucciones, scripts y recursos que Claude carga dinámicamente para mejorar el rendimiento en tareas especializadas".

La definición de OpenAI es similar: "Una skill es un directorio con un archivo SKILL.md más scripts y referencias opcionales. El archivo SKILL.md debe incluir name y description".

Ambas herramientas cargan las skills de la misma forma general. Codex comienza con el nombre y la descripción de cada skill y carga las instrucciones completas cuando decide usar una. Anthropic describe la versión de Claude también como una divulgación progresiva, donde Claude revisa las skills disponibles y carga las relevantes.

Por lo tanto, una carpeta de skill es mayoritariamente portátil. La cuestión es cómo llevar cada una a un lugar que Codex lea y qué cambiar en el camino.

Dónde viven sus Claude skills

Es posible que tenga skills en hasta tres lugares, y cada uno se mueve de forma diferente.

Skills en la aplicación Claude. Estas son skills que creó en el chat o subió como archivos ZIP en claude.ai o en Claude Desktop. Viven en su cuenta, no en una carpeta de su computadora. El centro de ayuda de Anthropic explica cómo obtener una copia: busque la skill en su lista de skills, abra sus detalles y descárguela. En el diseño actualizado, la lista de skills está bajo Plugins, que reemplazó al menú Customize.

Skills en Claude Code. Las skills personales viven en ~/.claude/skills/<nombre-de-la-skill>/SKILL.md. Las skills de proyecto viven en el .claude/skills/ de un repositorio. Las skills de plugins viven dentro del plugin.

Skills sincronizadas de claude.ai en Claude Code. Cuando inicia sesión en Claude Code con una cuenta de claude.ai, Claude Code descarga las skills de su cuenta en ~/.claude/skills/synced/. Estas son copias de las skills de su aplicación, no originales separados. La documentación dice que las ediciones allí no se guardan de vuelta, así que trate la versión de la aplicación como la fuente.

Antes de mover nada, enumere sus skills en cada lugar y anote cuáles son duplicados.

Qué trae el importador de Codex

Codex tiene un flujo de importación que cubre parte de esto. Según la documentación de importación de OpenAI, la aplicación de escritorio de ChatGPT puede importar desde Claude Code, Claude Cowork o Cursor, y la CLI puede importar desde Claude Code o Cursor. En la CLI, ejecuta /import en una sesión inactiva.

Su tabla de elementos importados incluye skills, que aterrizan en Codex skills, y comandos de barra (slash commands), que también se convierten en skills. La documentación añade una garantía importante durante una migración: "La importación no cambia ni elimina la configuración de su agente existente".

Así que para las skills que viven en Claude Code, el importador es lo primero que debe probar. Para las skills que creó en la aplicación Claude, la documentación de importación no menciona la aplicación Claude como fuente. Si usa Cowork, verifique qué ofrece la importación de la aplicación de escritorio en su lista de elementos. Para cualquier cosa que no figure allí, descargue la skill e instálela manualmente.

Cubrimos cómo el importador maneja los plugins de Claude Code, que pueden agrupar skills con hooks y servidores MCP, en nuestra guía sobre migrar plugins de Claude Code a Codex.

Dónde lee Codex las skills

Codex lee skills de cuatro tipos de ubicaciones:

  • Repositorio: .agents/skills en su carpeta actual y en cada carpeta superior hasta la raíz del repositorio.
  • Usuario: $HOME/.agents/skills, para skills que desea en cada repositorio.
  • Admin: /etc/codex/skills, una ubicación compartida del sistema.
  • Sistema: skills integradas con Codex, incluyendo skill-creator y skill-installer.

Las rutas difieren de las de Claude Code. Una skill personal de Claude Code en ~/.claude/skills/ se mapea a ~/.agents/skills/ en Codex. Una skill de proyecto en .claude/skills/ se mapea a .agents/skills/ en el repositorio.

Codex también maneja los nombres duplicados de forma diferente. La documentación dice: "Si dos skills comparten el mismo name, Codex no las combina; ambas pueden aparecer en los selectores de skills". Si importa una skill y luego copia la misma a mano, puede terminar con dos.

Qué campos de frontmatter se mantienen

Aquí es donde ocurre la edición.

La documentación de Anthropic divide el frontmatter de las skills en dos grupos. Claude Code acepta una larga lista de campos. Pero para las subidas de skills en claude.ai y la Skills API, solo se permiten seis: name, description, license, compatibility, metadata y allowed-tools.

Eso tiene una consecuencia útil. Las skills que subió a la aplicación Claude ya usan el formato compartido, por lo que necesitan menos edición.

Las skills escritas para Claude Code pueden usar campos en los que solo actúa Claude Code, como argument-hint, disable-model-invocation, paths, context, model, effort o hooks. La documentación de Codex requiere name y description y no describe esos otros campos, así que no cuente con que hagan nada en Codex.

Algunos de ellos tienen un equivalente en Codex:

  • disable-model-invocation: true evita que Claude invoque una skill por su cuenta. En Codex, el mismo efecto se logra con un archivo opcional agents/openai.yaml con allow_implicit_invocation establecido en false. La documentación de OpenAI dice que entonces Codex no invocará la skill implícitamente, y la invocación explícita seguirá funcionando.
  • Un name ausente funciona en Claude Code, que recurre al nombre de la carpeta. Codex lo requiere, así que añada uno.

Revise la descripción mientras está allí. Codex acorta las descripciones cuando hay muchas skills instaladas, y su documentación aconseja: "Coloque al principio el caso de uso clave y las palabras activadoras para que un host pueda seguir coincidiendo con la skill si las descripciones se acortan".

Qué no se transfiere en el cuerpo

Claude Code admite funciones dentro de las instrucciones de una skill que otras herramientas no. La documentación de Anthropic las nombra: "Las funciones del cuerpo exclusivas de Claude Code, como la inyección de contexto dinámico, no funcionan en el chat de claude.ai ni a través de la API".

Lo mismo se aplica al mudarse a Codex. Busque:

  • Líneas de shell que inyectan salida, escritas con un signo de exclamación antes de un comando. Claude Code las ejecuta antes de que se cargue la skill.
  • Marcadores de posición (placeholders) como ${CLAUDE_PROJECT_DIR} y sustituciones de argumentos.
  • Referencias a archivos con @ que Claude Code adjunta.

La documentación de importación de OpenAI enumera la misma categoría entre las cosas a revisar después de importar: "Plantillas de prompts o prompts de estilo comando que dependen de argumentos, interpolación de shell o marcadores de posición de rutas de archivos". Reescriba estos como instrucciones simples, o mueva el comando a un script en la carpeta scripts/ de la skill y dígale a Codex cuándo ejecutarlo.

Activar y desactivar skills en Codex

Una vez que sus skills estén en su lugar, es posible que desee que algunas estén disponibles pero inactivas. Codex le permite desactivar una skill sin eliminarla, usando entradas [[skills.config]] en ~/.codex/config.toml. Cada entrada apunta a una skill por su ruta o coincide con cada skill con un nombre dado, y la establece como desactivada. La documentación de OpenAI añade que cuando más de una entrada coincide con una skill, la última entrada coincidente gana.

Si una skill que añadió no aparece, la documentación dice que Codex detecta los cambios de skills automáticamente, y añade: "Si una actualización no aparece, reinicie Codex". Lo mismo se aplica después de cambiar el archivo de configuración.

Permisos de herramientas dentro de las skills

El campo allowed-tools de Claude Code preaprueba herramientas para el turno que invoca una skill. La documentación de importación de OpenAI enumera las "Restricciones o permisos de herramientas en skills y agentes importados" como algo a revisar después de importar.

Codex tiene su propio modelo de permisos, con sandboxing, aprobaciones y reglas de comandos. Una skill que se ejecutaba sin avisos en Claude Code puede pedir aprobación en Codex. Decida si ese es el comportamiento que desea antes de añadir reglas más amplias para silenciarlo.

Skills de espacio de trabajo y uso compartido

Si también usa skills en ChatGPT, la documentación de controles de skills de OpenAI separa tres tipos: skills de espacio de trabajo de ChatGPT, skills del sistema de archivos local y plugins. Advierte: "Mover una skill no transfiere la propiedad del espacio de trabajo de ChatGPT, el uso compartido, las asignaciones de roles, el estado de instalación del plugin o la autorización del conector".

Por lo tanto, una skill que su equipo compartió en Claude no llega compartida en Codex. Para darle al equipo la misma skill, la documentación de OpenAI recomienda empaquetarla como un plugin, que funciona en Codex y en ChatGPT.

Lo que la gente intenta primero

Copiar skills en ~/.codex. Codex lee las skills de usuario desde ~/.agents/skills.

Esperar que el importador encuentre las skills de la aplicación Claude. Descárguelas e instálelas a mano.

Mantener campos exclusivos de Claude Code. Codex requiere name y description y no describe el resto.

Dejar las líneas de inyección de shell en su lugar. Son una función de Claude Code.

Importar y copiar la misma skill. Codex mantiene ambas.

La migración manual

Paso 1: Liste sus Claude skills

Revise la lista de skills de la aplicación Claude, ~/.claude/skills, y el .claude/skills de cada repositorio.

Paso 2: Ejecute el importador para las skills de Claude Code

Use /import en la CLI de Codex, o Import en la configuración de la aplicación de escritorio de ChatGPT.

Paso 3: Descargue sus skills de la aplicación Claude

Guarde cada skill personalizada desde su página de detalles y descomprímala.

Paso 4: Coloque cada skill donde Codex la lea

Use ~/.agents/skills para skills personales y .agents/skills para skills de repositorio.

Paso 5: Edite el frontmatter

Mantenga name y description, y mueva la configuración de invocación a agents/openai.yaml.

Paso 6: Reescriba las funciones del cuerpo exclusivas de Claude Code

Reemplace la inyección de shell y los marcadores de posición con instrucciones o scripts.

Paso 7: Pruebe cada skill

Invóquela con $ o /skills, luego verifique que una solicitud coincidente la active.

La mejor manera: Mantenga los motivos detrás de sus skills en un solo lugar

Una skill registra cómo hacer una tarea. Los motivos detrás de ella, como por qué las notas de lanzamiento siguen esa estructura, qué revisor pidió una regla o qué caso extremo maneja un paso, pueden no estar en el archivo. Cuando los archivos se mueven a una nueva herramienta, los pasos llegan y el razonamiento se queda donde alguien lo recuerde.

MemoryLake es una capa de memoria para ese tipo de contexto de trabajo, como convenciones, decisiones y los motivos detrás de sus flujos de trabajo, mantenidos en un lugar que usted administra y disponibles para los asistentes que conecte, como ChatGPT, Claude Code y Codex.

Usted escribe las entradas usted mismo, con sus propias palabras. No se lee nada de, ni se escribe en, ni se borra de sus Claude skills, sus carpetas de Codex skills, su config.toml, sus plugins o la tienda de cualquier proveedor. Las skills funcionan de la manera que Anthropic y OpenAI describen.

Paso 1: Cree una clave API

Inicie sesión y genere una clave desde el panel de control. Guárdela fuera de sus repositorios, como cualquier otra credencial.

La consola de MemoryLake mostrando la pantalla de claves API, donde se crea y copia una nueva clave para usar en un agente
La consola de MemoryLake mostrando la pantalla de claves API, donde se crea y copia una nueva clave para usar en un agente

Paso 2: Suba sus primeras memorias

Comience con las skills que enumeró en el Paso 1 de la migración manual. Para cada una, escriba para qué sirve y por qué existen sus reglas. Una skill por entrada.

El espacio de trabajo de MemoryLake con los primeros documentos subidos, enumerando cada archivo a medida que se convierte en memoria buscable
El espacio de trabajo de MemoryLake con los primeros documentos subidos, enumerando cada archivo a medida que se convierte en memoria buscable

Paso 3: Conecte su IA y agentes

Conecte Codex, Claude Code y los demás asistentes que utilice. Cada uno puede recurrir a los mismos motivos, independientemente de qué herramienta ejecute la skill.

La pantalla de integraciones de MemoryLake enumerando los clientes de IA y los frameworks de agentes que pueden conectarse a la capa de memoria
La pantalla de integraciones de MemoryLake enumerando los clientes de IA y los frameworks de agentes que pueden conectarse a la capa de memoria

Qué cambia esto en la práctica

La primera diferencia es una edición más fácil. Cuando sabe por qué existe una regla, puede saber si una reescritura de Codex mantiene su significado.

La segunda es skills más limpias. Los datos que cambian rápidamente se quedan fuera de SKILL.md y en notas que actualiza por separado.

La tercera es la consistencia entre herramientas. Los mismos motivos están disponibles en Claude Code y Codex mientras usa ambos.

Mejores prácticas para mover Claude skills a Codex

Empiece con el importador. Maneja las skills de Claude Code y deja su configuración de Claude intacta.

Trate las skills de la aplicación como la fuente. Las copias sincronizadas en Claude Code no se guardan de vuelta.

Use los campos compartidos. name y description funcionan en ambas herramientas.

Coloque las descripciones al principio. Codex puede acortarlas.

Evite nombres duplicados. Codex no los combina.

Empaquete las skills compartidas como plugins. El uso compartido no se mueve con los archivos.

Conclusión

Claude y Codex crean skills sobre el mismo formato abierto, por lo que una carpeta de skill con un archivo SKILL.md es mayoritariamente portátil. El importador de Codex trae las skills de Claude Code y los comandos de barra sin cambiar su configuración de Claude, mientras que las skills que creó en la aplicación Claude deben descargarse y colocarse en ~/.agents/skills o en el .agents/skills de un repositorio manualmente.

Las skills subidas a la aplicación Claude ya usan los campos compartidos. Las skills escritas para Claude Code pueden necesitar que se recorte su frontmatter, que la configuración de invocación se mueva a agents/openai.yaml y que las funciones exclusivas de Claude Code, como la inyección de shell, se reescriban. El uso compartido, la propiedad y la autorización del conector no se mueven con los archivos, así que planifique eso por separado.

Preguntas frecuentes

¿Puede Codex usar Claude skills?

Sí. Ambos se basan en el estándar abierto de skills para agentes, por lo que una carpeta SKILL.md puede moverse con algunas ediciones.

¿Importa Codex las skills de Claude?

El importador de Codex trae las skills de Claude Code. Las skills de la aplicación Claude deben descargarse y añadirse a mano.

¿Dónde pongo las skills para Codex?

Use ~/.agents/skills para skills personales y .agents/skills en un repositorio.

¿Cómo descargo una skill de Claude?

Abra los detalles de la skill en su lista de skills y descárguela.

¿Qué frontmatter necesita Codex?

name y description son obligatorios.

¿Cómo evito que Codex use una skill automáticamente?

Establezca allow_implicit_invocation en false en el archivo agents/openai.yaml de la skill.

¿La importación cambia mi configuración de Claude Code?

No. OpenAI afirma que la importación no cambia ni elimina su configuración existente.