Resumen rápido: Las habilidades de Codex son paquetes reutilizables de instrucciones, scripts y recursos que extienden el agente de codificación de OpenAI’s Codex con capacidades específicas para tareas. Permiten a los desarrolladores estandarizar flujos de trabajo, compartir experiencia entre equipos y ayudar a Codex a ejecutar tareas complejas de manera más confiable sin repetir instrucciones detalladas cada vez.
El Codex de OpenAI representa un cambio fundamental en la forma en que los desarrolladores interactúan con el código. Pero aquí está el detalle: incluso el agente de codificación más avanzado se beneficia de una guía estructurada. Ahí es exactamente donde entran las habilidades de Codex.
Las habilidades transforman Codex de un asistente de codificación de propósito general a una potencia de automatización de flujos de trabajo especializada. En lugar de crear las mismas instrucciones detalladas repetidamente, los desarrolladores empaquetan sus mejores prácticas en unidades compartibles y reutilizables que Codex ejecuta de manera consistente.
¿Qué son las habilidades de Codex?
Según la documentación para desarrolladores de OpenAI, las habilidades son paquetes reutilizables que agrupan instrucciones, recursos y scripts opcionales para ayudar a Codex a completar tareas específicas. Piénselas como módulos de experiencia que extienden lo que Codex puede hacer de manera confiable.
Las habilidades se basan en el estándar abierto de habilidades de agente, lo que las hace compatibles en la CLI de Codex, las extensiones de IDE y la aplicación Codex. Cuando un desarrollador crea una habilidad, esta se vuelve disponible en todas partes donde trabaja con Codex.
La arquitectura utiliza la divulgación progresiva para administrar el contexto de manera eficiente. Codex comienza con los metadatos de cada habilidad (nombre, descripción, ruta del archivo y metadatos opcionales de agentes/openai.yaml) en lugar de consumir inmediatamente las instrucciones completas de SKILL.md, cargando las instrucciones completas solo cuando decide usar una habilidad.
Cómo funcionan las habilidades en la práctica
Los desarrolladores pueden invocar una habilidad directamente usando la sintaxis $.nombre-habilidad, o dejar que Codex elija automáticamente la habilidad apropiada según la tarea en cuestión. Este enfoque dual equilibra el control explícito con la automatización inteligente.
Las habilidades se pueden descubrir a través de los subdirectorios de habilidades de los plugins instalados y los directorios de habilidades en el entorno de Codex. Cuando se instalan habilidades, Codex las detecta automáticamente.
Configuración de habilidades de Codex
El soporte de habilidades en Codex se lanzó como una función experimental el 15 de diciembre de 2025. Según las discusiones de la comunidad en el Foro de Desarrolladores de OpenAI, habilitar habilidades requiere una bandera de función en la CLI de Codex.
Los desarrolladores activan las habilidades ejecutando codex --enable skills. Este comando desbloquea el sistema de habilidades en todas las interfaces de Codex donde se aplica la configuración de la CLI.
Las habilidades se pueden instalar desde el catálogo oficial de habilidades de OpenAI en GitHub, que contiene habilidades aportadas por la comunidad para flujos de trabajo de desarrollo comunes.
Dónde residen las habilidades
Las habilidades se almacenan en directorios designados que Codex escanea durante la inicialización. Las ubicaciones más comunes incluyen:
- El directorio .codex/skills en la raíz del proyecto
- Subdirectorios de habilidades específicos de plugins
- Directorios de habilidades a nivel de sistema configurados en el entorno de Codex
Esta estructura flexible permite a los equipos compartir habilidades para toda la organización mientras mantienen personalizaciones específicas del proyecto.
Utiliza las herramientas de Codex sin pagar el precio completo
Trabajar con configuraciones de Codex generalmente implica combinar múltiples herramientas: APIs, editores, asistentes. Los costos se acumulan rápidamente, especialmente cuando se prueban diferentes flujos de trabajo.
Get AI Perks ayuda a reducir ese gasto. Agrega créditos, descuentos y ofertas de socios en herramientas de IA, para que no tenga que pagar por cada una por separado mientras averigua qué funciona.
Con Get AI Perks, puedes:
- acceder a créditos para herramientas y APIs de codificación de IA
- probar diferentes configuraciones sin precios completos
- evitar acumular múltiples suscripciones
Si trabajas con herramientas de Codex, comienza por reducir tus costos: consulta Get AI Perks.
Creación de tus propias habilidades
En su nivel más básico, una habilidad es solo un archivo Markdown. Esta simplicidad hace que la creación de habilidades sea accesible para cualquier desarrollador que pueda documentar un flujo de trabajo.
El archivo Markdown contiene instrucciones que guían a Codex a través de una tarea específica. Para escenarios más complejos, las habilidades pueden incluir recursos adicionales como plantillas de configuración, archivos de ejemplo o scripts ejecutables que Codex ejecuta como parte del flujo de trabajo.
| Componente de la habilidad | Propósito | Requerido |
|---|---|---|
| Metadatos | Nombre, descripción, disparadores | Sí |
| Instrucciones | Guía paso a paso de la tarea | Sí |
| Recursos | Plantillas, ejemplos, configuraciones | No |
| Scripts | Código de automatización ejecutable | No |
Los metadatos de la habilidad le dicen a Codex cuándo y cómo usar la habilidad. Metadatos bien elaborados aseguran que Codex seleccione la habilidad correcta automáticamente cuando los desarrolladores describen su tarea en lenguaje natural.
Descubrimiento y selección de habilidades
Cuando un desarrollador emite una indicación, Codex compara la intención con su índice de habilidades. El sistema considera factores como las palabras clave de la descripción de la tarea, el contexto del proyecto y las invocaciones exitosas anteriores de habilidades para seleccionar la habilidad más apropiada.
Modelos y capacidades de Codex
Codex está impulsado por modelos de IA especializados optimizados para tareas de codificación. Según la documentación de modelos de OpenAI, Codex se basó principalmente en la familia GPT-3. OpenAI ha descontinuado desde entonces los modelos específicos de Codex (como code-davinci-002) en favor de los modelos de las series GPT-3.5 Turbo y GPT-4, que integran capacidades de codificación.
GPT-5.3 ofrece un rendimiento de codificación líder en la industria para tareas complejas de ingeniería de software. Este modelo sobresale en la comprensión de bases de código, la generación de código preciso y el seguimiento de flujos de trabajo de varios pasos.
GPT-5.4 representa el modelo insignia de vanguardia, que combina las capacidades de codificación de GPT-5.3-Codex con un razonamiento más sólido, uso de herramientas y flujos de trabajo de agentes. Esto lo hace particularmente efectivo para tareas que requieren tanto experiencia en codificación como resolución de problemas más amplia.
Ambos modelos están disponibles a través de la CLI de Codex, el SDK, la aplicación, las extensiones de IDE y Codex Cloud. Las habilidades funcionan de manera consistente en todas estas interfaces, independientemente del modelo subyacente que ejecute la tarea.
Casos de uso del mundo real
Las discusiones de la comunidad revelan cómo los equipos de desarrollo implementan habilidades en diversos escenarios. Aquí hay patrones que emergen del uso real:
Automatización de revisiones de código: Los equipos crean habilidades que imponen estándares de revisión específicos de la organización. La habilidad guía a Codex a través de la verificación de convenciones de estilo, patrones de seguridad y decisiones arquitectónicas específicas de la base de código.
Flujos de trabajo de Git: Las habilidades estandarizan los formatos de mensajes de commit, las convenciones de nombres de ramas y las estrategias de fusión. En lugar de documentar esto en una wiki que los desarrolladores olvidan consultar, la habilidad asegura que Codex siga automáticamente las prácticas de Git del equipo.
Entornos de prueba: Las habilidades empaquetan los pasos para ejecutar conjuntos de pruebas específicos del proyecto, incluida la configuración del entorno, la ejecución de pruebas y la interpretación de resultados. Esto resulta particularmente valioso para proyectos complejos con flujos de trabajo de pruebas de varios pasos.
Habilidades vs. Documentación tradicional
| Aspecto | Documentos tradicionales | Habilidades de Codex |
|---|---|---|
| Ejecución | Interpretación manual | Flujo de trabajo automatizado |
| Actualizaciones | A menudo desactualizado | Probado con cada uso |
| Consistencia | Varía según el desarrollador | Ejecución estandarizada |
| Compartibilidad | Wiki o README | Paquetes de archivos portátiles |
| Descubrimiento | Buscar y leer | Coincidencia automática |
El estándar abierto de habilidades de agente
Las habilidades de Codex se basan en un estándar abierto que se extiende más allá de la implementación de OpenAI. Esta estandarización es importante porque crea portabilidad entre diferentes herramientas de codificación de IA.
El estándar define cómo las habilidades estructuran metadatos, empaquetan recursos y declaran dependencias. Las herramientas que adoptan este estándar pueden compartir bibliotecas de habilidades, reduciendo la duplicación y acelerando el crecimiento del ecosistema.
Según las discusiones de Hacker News, el enfoque de estándar abierto representa una ventaja significativa sobre las alternativas propietarias. Las habilidades creadas para Codex pueden funcionar potencialmente con otros agentes compatibles, aunque la compatibilidad específica depende de la implementación de cada herramienta.
Habilitación de habilidades: Estado actual
A partir de diciembre de 2025, el soporte de habilidades en Codex sigue siendo experimental. La función requiere activación explícita a través del sistema de banderas de la CLI, lo que indica que OpenAI continúa refinando la implementación basándose en los comentarios de los desarrolladores.
Las habilidades están disponibles para usuarios de ChatGPT Plus, Pro, Business, Edu y Enterprise. Según el anuncio oficial del 16 de mayo de 2025, Codex estuvo disponible para usuarios de ChatGPT Pro, Business y Enterprise, y los usuarios Plus se agregaron a partir del 3 de junio de 2025.
La finalización de tareas suele tardar entre 1 y 30 minutos, dependiendo de la complejidad. Codex puede leer y editar archivos, ejecutar comandos, incluidos entornos de prueba, linters y comprobadores de tipos. Las habilidades mejoran estas capacidades básicas al empaquetar flujos de trabajo específicos del dominio.
Recursos y catálogos comunitarios
El repositorio oficial de habilidades de OpenAI en GitHub sirve como catálogo principal. Los desarrolladores aportan habilidades para flujos de trabajo comunes, creando una base de conocimiento compartida que crece con la comunidad.
Colecciones mantenidas por la comunidad como el awesome-codex-skills de ComposioHQ curan habilidades prácticas para automatizar flujos de trabajo en la CLI y la API de Codex. Estas listas curadas ayudan a los desarrolladores a descubrir habilidades probadas en lugar de construir todo desde cero.
El modelo de contribución refleja proyectos exitosos de código abierto. Los desarrolladores envían habilidades a través de solicitudes de extracción (pull requests), los mantenedores revisan la calidad y utilidad, y el catálogo se expande orgánicamente según las necesidades reales.
Preguntas frecuentes
¿Necesito mencionar explícitamente las habilidades al usar Codex?
No necesariamente. Codex puede seleccionar automáticamente las habilidades apropiadas según el contexto de la tarea. Sin embargo, los desarrolladores pueden invocar habilidades específicas directamente usando la sintaxis $.nombre-habilidad cuando desean un control explícito sobre qué habilidad se ejecuta.
¿Pueden las habilidades funcionar en diferentes proyectos?
Sí. Las habilidades instaladas en directorios a nivel de sistema se vuelven disponibles en todos los proyectos. Las habilidades específicas del proyecto en los directorios .codex/skills permanecen locales a esa base de código, lo que permite a los equipos equilibrar estándares compartidos con personalización de proyectos.
¿Cómo difieren las habilidades del Protocolo de Contexto del Modelo (MCP)?
Según las discusiones de la comunidad, las habilidades son más fáciles de crear y se centran más en empaquetar flujos de trabajo. MCP proporciona capacidades de integración más amplias. Las habilidades sobresalen en la estandarización de tareas repetibles, mientras que MCP permite integraciones de herramientas más profundas. Muchos desarrolladores usan ambas juntas.
¿Qué sucede si una habilidad falla durante la ejecución?
Codex consume la habilidad completa en el contexto y no comienza con ejecuciones fallidas, según los comentarios de los desarrolladores. A diferencia de algunos enfoques que comienzan con ejecuciones fallidas, las habilidades cargan el contexto completo para ayudar al modelo a comprender el flujo de trabajo completo.
¿Pueden las habilidades incluir dependencias externas o scripts?
Sí. Las habilidades soportan scripts opcionales y pueden referenciar recursos externos. Esto permite que las habilidades complejas incluyan automatización de configuración, scripts de validación o integración con herramientas externas como linters y comprobadores de tipos.
¿Son las habilidades compatibles con las extensiones IDE de Codex?
Las habilidades están disponibles en la CLI de Codex, la extensión IDE y la aplicación Codex, funcionando de manera consistente en todas estas interfaces. Una vez habilitadas e instaladas, las habilidades permanecen accesibles independientemente de dónde ocurra el desarrollo.
¿Cómo comparto habilidades con mi equipo?
Los equipos pueden compartir habilidades a través del control de versiones al confirmar el directorio .codex/skills, o al mantener repositorios internos de habilidades que los miembros del equipo instalan. Las habilidades para toda la organización pueden residir en directorios de plugins compartidos.
Primeros pasos con las habilidades de Codex
La barrera de entrada se mantiene deliberadamente baja. Los desarrolladores ya familiarizados con Markdown pueden crear habilidades básicas de inmediato. Para los equipos que recién comienzan, comience con un único flujo de trabajo que cause fricción en el desarrollo diario.
Documente ese flujo de trabajo como una habilidad. Pruébelo. Refine según los resultados de ejecución reales. Luego, expanda a flujos de trabajo adicionales a medida que el equipo gane confianza con el sistema de habilidades.
La arquitectura de divulgación progresiva significa que comenzar de forma sencilla no crea deuda técnica. Las habilidades crecen en complejidad solo cuando los requisitos lo exigen, no porque el sistema fuerce una estructura elaborada desde el principio.
¿Listo para extender las capacidades de tu agente de codificación? Consulta la documentación oficial de OpenAI para conocer la disponibilidad actual de funciones e instrucciones de instalación. El ecosistema de habilidades continúa evolucionando rápidamente a medida que más desarrolladores aportan su experiencia.
