MemoryLake
Volver a todos los artículos
Tutorial18 de noviembre de 2026·11 min de lectura

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

Ha creado un conjunto de skills en Codex durante los últimos meses: una que prepara un lanzamiento, otra que escribe scripts de migración tal como le gusta a su equipo, otra que clasifica pruebas inestables. Ahora parte de su trabajo se ejecuta en Claude Code y desea tener las mismas skills allí. Copió una carpeta en su repositorio, abrió Claude Code y escribió el nombre de la skill. No apareció nada.

La skill en sí estaba bien. Estaba en el lugar equivocado. Codex y Claude Code utilizan el mismo formato de skill, pero cada uno busca skills en sus propias carpetas. La documentación de OpenAI dice: "Para los repositorios, Codex escanea .agents/skills en cada directorio desde su directorio de trabajo actual hasta la raíz del repositorio". Claude Code busca en .claude/skills/.

Esta guía cubre qué es una skill en cada herramienta, dónde busca cada una, qué se transfiere sin cambios, qué no tiene una correspondencia directa, dos formas de trasladar sus skills, cómo mantener una sola copia en lugar de dos y cómo mantener el razonamiento detrás de sus skills disponible independientemente de la herramienta en la que se encuentre.

Qué es una skill en Codex y en Claude Code

Ambas herramientas se basan en el mismo estándar abierto. La documentación de OpenAI dice: "Las skills se basan en el estándar abierto de agent skills". La de Anthropic dice: "Las skills de Claude Code siguen el estándar abierto Agent Skills, que funciona en múltiples herramientas de AI".

En Codex, OpenAI describe la estructura: "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". Una carpeta de skill también puede contener scripts/, references/, assets/ y un archivo agents/openai.yaml.

En Claude Code, una skill también es una carpeta con un archivo SKILL.md. El frontmatter entre los marcadores --- le indica a Claude cuándo usar la skill, y el markdown debajo contiene las instrucciones.

Por lo tanto, el núcleo de una skill (la carpeta, el archivo SKILL.md, su name, su description y sus instrucciones) tiene el mismo formato en ambas herramientas. Esa es la buena noticia para una migración. La mayor parte del trabajo consiste en la ubicación y en las pocas partes que cada herramienta añade sobre el estándar.

Dónde busca cada herramienta las skills

Esto explica el ejemplo inicial.

Codex lee skills de ubicaciones de repositorio, usuario, administrador y sistema:

  • Repositorio: .agents/skills en el directorio de trabajo actual y en cada carpeta hasta la raíz del repositorio.
  • Usuario: $HOME/.agents/skills, para skills que se aplican en cualquier repositorio.
  • Administrador: /etc/codex/skills, compartidas en la máquina.
  • Sistema: skills integradas con Codex, como skill-creator y skill-installer.

Claude Code lee skills de estas ubicaciones:

  • Proyecto: .claude/skills/<nombre-de-la-skill>/SKILL.md en el repositorio.
  • Personal: ~/.claude/skills/<nombre-de-la-skill>/SKILL.md, para todos sus proyectos en esa máquina.
  • Enterprise: un directorio de configuración gestionado que despliega su organización.
  • Plugins: skills integradas en un plugin que haya habilitado.

La documentación de ninguna herramienta menciona las carpetas de la otra. Por lo tanto, asuma que una skill en .agents/skills no aparecerá en Claude Code hasta que esté en .claude/skills/, y lo mismo a la inversa.

Hay una diferencia más para los monorepos. La documentación de Anthropic dice que Claude Code "carga las skills del proyecto desde .claude/skills/ en el directorio donde se inicia y en cada directorio padre hasta la raíz del repositorio". Añade: "Las skills en un directorio .claude/skills/ por debajo de donde se inició no se cargan al inicio". Se cargan la primera vez que Claude lee o edita un archivo en ese subdirectorio.

Qué se transfiere sin cambios

Debido a que ambas herramientas siguen el mismo estándar, las partes que más escribe se transfieren tal cual:

  • El nombre de la carpeta y SKILL.md. La estructura es la misma.
  • name y description. Ambas herramientas usan la descripción para decidir cuándo se aplica una skill.
  • Las instrucciones. El cuerpo del markdown es texto plano que cualquier herramienta puede seguir.
  • Archivos de soporte. Los scripts, referencias y plantillas dentro de la carpeta de la skill se trasladan con ella.

Las descripciones merecen una segunda revisión después del traslado. El consejo de OpenAI para Codex es "escribir descripciones concisas con un alcance y límites claros". La documentación de Anthropic añade un límite para Claude Code: "el texto combinado de description y when_to_use se trunca a 1,536 caracteres en el listado de skills para reducir el uso de contexto". Una descripción que es larga pero aceptable en Codex puede quedar cortada en el listado de Claude Code.

Qué no tiene una correspondencia directa

Algunas partes de una skill de Codex son específicas de los productos de OpenAI.

agents/openai.yaml. OpenAI describe el propósito de este archivo: "Añada agents/openai.yaml para configurar metadatos de la UI en la aplicación de escritorio de ChatGPT, para establecer la política de invocación y para declarar dependencias de herramientas para una experiencia más fluida al usar la skill". Contiene nombres de visualización e iconos, la política de invocación implícita y dependencias como un servidor MCP. La documentación de skills de Claude Code no describe la lectura de este archivo.

Política de invocación. En Codex, la sección policy de ese archivo contiene ajustes como allow_implicit_invocation. Claude Code tiene su propio campo de frontmatter para la misma idea, disable-model-invocation. La documentación dice: "Establézcalo en true para evitar que Claude cargue automáticamente esta skill". Si había desactivado la invocación implícita para una skill en Codex, configure este campo en el SKILL.md de la skill después del traslado.

Dependencias de herramientas. Si una skill de Codex declara un servidor MCP en openai.yaml, Claude Code necesita que ese servidor se configure por separado. Verifique que las instrucciones de la skill sigan funcionando sin él, o añada el servidor a Claude Code.

Cómo se llama a una skill. En la CLI de Codex o en la extensión del IDE, OpenAI dice que se debe "ejecutar /skills o escribir $ para mencionar una skill". En Claude Code, se invoca una skill directamente con /nombre-de-la-skill.

Nombres duplicados. OpenAI señala: "Si dos skills comparten el mismo name, Codex no las combina; ambas pueden aparecer en los selectores de skills". Claude Code también mantiene disponibles las skills anidadas con el mismo nombre. Si está combinando conjuntos de skills, cambie el nombre de las que entren en conflicto antes de confiar en ellas.

Ruta 1: Usar /import

Claude Code tiene un comando para esto. Su referencia de comandos describe /import como una forma de traer la configuración de OpenAI Codex y otros agentes de programación en su máquina a Claude Code, "incluyendo archivos de instrucciones, servidores MCP, comandos, subagentes y skills".

Dos opciones hacen que sea más seguro ejecutarlo:

  • Vista previa primero. La referencia dice: "Añada --dry-run para una vista previa sin escribir nada, o --yes para omitir el selector interactivo".
  • Ejecutarlo desde la terminal. claude import inicia una sesión interactiva que ejecuta /import, con las mismas opciones.

Cuando configura un nuevo proyecto, /init también ofrece trasladar la configuración de Codex con /import si encuentra alguna.

Hay un detalle en la documentación de memoria de Anthropic que vale la pena leer antes de ejecutarlo. Dice que /import "añade una copia única de archivos de instrucciones como AGENTS.md al CLAUDE.md correspondiente y traslada servidores MCP, comandos, subagentes y skills".

Las palabras clave son copia única. Después de la importación, su AGENTS.md y su CLAUDE.md son archivos separados. Si cambia una convención en AGENTS.md el próximo mes, Claude Code no la verá a menos que también actualice CLAUDE.md o ejecute la importación de nuevo. El mismo razonamiento se aplica a las skills: una vez que se copia una skill, editar la versión de Codex no cambia la versión de Claude Code.

La documentación no describe cómo maneja /import el archivo agents/openai.yaml u otros metadatos específicos de OpenAI. Después de una importación, abra cada skill en Claude Code y verifique su frontmatter y archivos de soporte.

Ruta 2: Mantener una sola copia con un symlink

Si seguirá usando ambas herramientas, dos copias de cada skill acabarán divergiendo. Ambas herramientas admiten carpetas de skills vinculadas simbólicamente (symlinks), lo que le permite mantener una sola fuente.

La documentación de OpenAI dice: "Codex admite carpetas de skills vinculadas simbólicamente y sigue el destino del symlink al escanear estas ubicaciones".

La de Anthropic dice que una entrada de skill en la ubicación de enterprise, personal o de proyecto puede ser un symlink a un directorio en otra parte del disco. "Claude Code lee SKILL.md desde el destino y carga la skill una sola vez incluso si varias ubicaciones apuntan al mismo destino".

Un esquema sencillo es mantener cada skill en una carpeta real y apuntar la ubicación de la otra herramienta hacia ella:

  • Mantenga la skill en .agents/skills/release-notes/, donde Codex la encuentra.
  • Añada .claude/skills/release-notes como un symlink a esa carpeta.

Las ediciones en el único SKILL.md llegarán entonces a ambas herramientas. Codex "detecta los cambios en las skills automáticamente", y su documentación dice que se debe reiniciar Codex si una actualización no aparece. Si una edición no se muestra en Claude Code, inicie una nueva sesión.

Se aplican dos advertencias. Una skill vinculada simbólicamente comparte una descripción, así que escríbala para que funcione en los listados de ambas herramientas. Y el frontmatter exclusivo de Claude Code, como disable-model-invocation, residirá en un archivo que Codex también lee, así que pruebe que Codex siga cargando la skill después de añadirlo.

Skills personales

Las mismas opciones se aplican a las skills que guarda para usted mismo en lugar de en un repositorio. Codex lee las skills personales de $HOME/.agents/skills. Claude Code las lee de ~/.claude/skills/. Puede copiarlas, ejecutar /import o crear symlinks para carpetas de skills individuales.

La documentación de Anthropic reserva un nombre de carpeta en la ubicación personal. Claude Code utiliza ~/.claude/skills/synced/ para las skills descargadas de su cuenta de claude.ai, así que no nombre a una de sus propias skills synced.

Si ha realizado el camino inverso anteriormente, surgieron las mismas preguntas sobre ubicación y empaquetado para los plugins. Cubrimos esa dirección en nuestra guía sobre migración de plugins de Claude Code a Codex.

Qué verificar antes de empezar

  • Qué skills usa realmente. Una migración es un buen momento para descartar skills que nadie llama.
  • Qué skills dependen de metadatos específicos de OpenAI. Busque archivos agents/openai.yaml con políticas de invocación o dependencias de MCP.
  • Si seguirá usando Codex. En caso afirmativo, planifique el uso de symlinks. Si no, una copia o /import es suficiente.
  • Conflictos de nombres. Compare los nombres de las skills en ambas herramientas.
  • Su archivo AGENTS.md. Decida si Claude Code debe leer una copia o si mantendrá ambos archivos.

Lo que la gente intenta primero

Copiar .agents/skills en el repositorio y esperar que Claude Code lo encuentre. Claude Code lee .claude/skills/.

Asumir que /import mantiene los archivos sincronizados. Añade una copia única de los archivos de instrucciones.

Dejar que los ajustes de openai.yaml se transfieran solos. Configure disable-model-invocation en Claude Code si una skill no debe ejecutarse automáticamente.

Mantener las descripciones largas tal como están. Claude Code trunca el texto de la descripción combinada en su listado.

Mantener dos copias de la misma skill. Divergirán. Use un symlink si va a mantener ambas herramientas.

La migración manual

Paso 1: Liste sus skills de Codex

Reúna las skills en .agents/skills en todo su repositorio, en $HOME/.agents/skills y en cualquier ubicación de administrador que utilice.

Paso 2: Vista previa de la importación

Ejecute /import con --dry-run en Claude Code para ver qué traería.

Paso 3: Importar o vincular

Ejecute la importación o cree symlinks desde .claude/skills/ a las carpetas de skills que mantendrá en un solo lugar.

Paso 4: Ajustar el frontmatter

Añada disable-model-invocation donde una skill de Codex tenía desactivada la invocación implícita y acorte las descripciones largas.

Paso 5: Reconectar dependencias

Configure cualquier servidor MCP del que dependiera una skill a través de openai.yaml.

Paso 6: Probar cada skill por nombre

Invoque cada skill con /nombre-de-la-skill, luego intente una solicitud que debería activarla automáticamente.

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

Una skill captura cómo hacer una tarea. Los motivos detrás de ella, como por qué la lista de verificación de lanzamiento tiene un paso manual, qué patrón de migración reemplazó a uno más antiguo o qué no debería tocar nunca una skill de clasificación de pruebas, son contexto del proyecto. Cuando mueve skills entre herramientas, las instrucciones se trasladan, pero la historia de por qué dicen lo que dicen puede vivir solo en la memoria de alguien.

MemoryLake es una capa de memoria para ese tipo de contexto de proyecto, como decisiones, convenciones y los motivos detrás de sus flujos de trabajo, mantenidos en un solo lugar que usted gestiona 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 carpetas de skills, sus archivos SKILL.md, sus archivos AGENTS.md o CLAUDE.md, sus ajustes de Codex o Claude Code, ni ningún almacén de proveedores. Las skills y /import funcionan de la manera que OpenAI y Anthropic describen.

Paso 1: Crear una API key

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 API keys, donde se crea y copia una nueva clave para usar en un agente
La consola de MemoryLake mostrando la pantalla de API keys, donde se crea y copia una nueva clave para usar en un agente

Paso 2: Subir sus primeras memorias

Comience con las skills que listó en el Paso 1 de la migración manual. Para cada una, escriba por qué existe y qué no debe cambiar. Una skill por entrada.

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

Paso 3: Conectar su AI y agentes

Conecte Claude Code, Codex 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 listando los clientes de AI y frameworks de agentes que pueden conectarse a la capa de memoria
La pantalla de integraciones de MemoryLake listando los clientes de AI y frameworks de agentes que pueden conectarse a la capa de memoria

Qué cambia esto en la práctica

La primera diferencia es una migración más limpia. Las skills pueden reducirse a instrucciones, porque la historia vive en otro lugar.

La segunda es la consistencia entre herramientas. El mismo razonamiento está disponible en Claude Code y en Codex.

La tercera es la facilidad de las actualizaciones. Cuando cambia una convención, actualiza una entrada y la skill que la sigue.

Mejores prácticas para mover Codex skills a Claude Code

Ponga las skills donde Claude Code busca. Use .claude/skills/ o ~/.claude/skills/.

Vista previa antes de importar. Use --dry-run.

Recuerde la copia única. Los archivos de instrucciones no se mantienen sincronizados después de /import.

Use symlinks si usará ambas herramientas. Una sola carpeta evita la divergencia.

Traduzca la política de invocación. Use disable-model-invocation en Claude Code.

Mantenga las descripciones cortas. Ambas herramientas coinciden basándose en ellas, y Claude Code trunca las largas.

Pruebe por nombre y por solicitud. Verifique tanto la invocación manual como la automática.

Conclusión

Codex y Claude Code utilizan el mismo formato de skill, basado en el estándar abierto de agent skills, por lo que la carpeta de la skill, el archivo SKILL.md, el nombre, la descripción y las instrucciones se transfieren sin cambios. Lo que difiere es dónde busca cada herramienta: .agents/skills para Codex y .claude/skills/ para Claude Code. Los metadatos específicos de Codex en agents/openai.yaml necesitan un equivalente en Claude Code, como disable-model-invocation.

Puede trasladar las skills con /import, que también añade una copia única de archivos de instrucciones como AGENTS.md, o mantener una sola copia con un symlink que ambas herramientas sigan. De cualquier manera, verifique cada skill después del traslado y mantenga los motivos detrás de sus skills en algún lugar que ambas herramientas puedan usar.

Preguntas frecuentes

¿Puede Claude Code usar skills de Codex?

Sí. Ambas siguen el mismo estándar abierto. Mueva o vincule la carpeta de la skill a .claude/skills/ para que Claude Code pueda encontrarla.

¿Dónde busca Claude Code las skills?

En .claude/skills/ en el proyecto y sus directorios padres, en ~/.claude/skills/, en ajustes gestionados y en plugins habilitados.

¿Trae /import las skills de Codex?

Sí. La referencia de comandos de Claude Code enumera las skills entre la configuración que trae /import, junto con archivos de instrucciones, servidores MCP, comandos y subagentes.

¿Mantiene /import sincronizados AGENTS.md y CLAUDE.md?

No. La documentación de Anthropic dice que añade una copia única de los archivos de instrucciones.

¿Puedo usar una sola carpeta de skill para ambas herramientas?

Sí. Tanto Codex como Claude Code admiten carpetas de skills vinculadas simbólicamente (symlinks).

¿Qué sucede con agents/openai.yaml?

La documentación de skills de Claude Code no describe su lectura. Establezca opciones equivalentes, como disable-model-invocation, en SKILL.md.

¿Cómo llamo a una skill migrada en Claude Code?

Escriba / seguido del nombre de la skill, o describa una tarea que coincida con su descripción.

Lecturas relacionadas