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/skillsen 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-creatoryskill-installer.
Claude Code lee skills de estas ubicaciones:
- Proyecto:
.claude/skills/<nombre-de-la-skill>/SKILL.mden 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. nameydescription. 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-runpara una vista previa sin escribir nada, o--yespara omitir el selector interactivo". - Ejecutarlo desde la terminal.
claude importinicia 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-notescomo 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.yamlcon 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
/importes 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.

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.

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.

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.