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/skillsen 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-creatoryskill-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: trueevita que Claude invoque una skill por su cuenta. En Codex, el mismo efecto se logra con un archivo opcionalagents/openai.yamlconallow_implicit_invocationestablecido 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
nameausente 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.

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.

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.

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.