Plugins vs skills en Codex.
Una skill le enseña a Codex a hacer un tipo de trabajo. Un plugin es el paquete que instalas, y puede incluir varias skills y las herramientas que necesitan. Así encajan entre sí y así sabrás a cuál recurrir.
Actualizado el 1 de noviembre de 2026 · 6 min de lectura
La respuesta corta
| Skill | Plugin | |
|---|---|---|
| Qué es | Una carpeta de instrucciones, con scripts y archivos de referencia opcionales | Un paquete instalable de capacidades |
| Contiene | Un archivo SKILL.md, más scripts y recursos opcionales | Skills, servidores MCP, extensiones de navegador y hooks |
| ¿Añade herramientas nuevas? | No. Guía a Codex con las herramientas que ya tiene | Sí, mediante los servidores MCP que incluye |
| Cómo se consigue | Copia la carpeta o usa $skill-installer | Se instala desde el directorio de plugins o un marketplace |
| Ideal para | Tus propios flujos de trabajo, en un repositorio o en tu equipo | Compartir un flujo de trabajo completo con otras personas |
¿Qué es una skill de Codex?
Una skill es un directorio con un archivo SKILL.md. El archivo empieza con un name y una description, seguidos de instrucciones escritas en Markdown normal. La carpeta también puede contener scripts/, references/ y assets/.
---
name: brand-ui-review
description: Review UI mockups against our brand guidelines. Use when the user asks for a design review.
---
Check every screen for:
- Colors from the brand palette only
- Inter for UI text, 16px minimum for body copy
- 8px spacing grid
Al principio, Codex solo lee el nombre y la descripción de cada skill. Cuando una tarea encaja con una descripción, o cuando mencionas la skill por su nombre, carga las instrucciones completas. Así puedes tener muchas skills disponibles sin llenar la ventana de contexto.
Dónde se guardan las skills
- En un repositorio:
.agents/skills. Codex revisa cada directorio desde donde estás trabajando hasta la raíz del repositorio. - Para tu usuario:
~/.agents/skills - Para una organización:
/etc/codex/skills, gestionado por un administrador. - Integradas: skills del sistema que vienen con Codex.
Cómo usar una
En Codex CLI o en la extensión para IDE, ejecuta /skills o escribe $ para mencionar una skill directamente. Codex también puede elegir una skill por su cuenta cuando tu petición encaja con su descripción. Para crear una skill, pídeselo a la skill integrada $skill-creator. Para instalar una desde un catálogo o un repositorio, usa $skill-installer. Reinicia Codex si una skill nueva no aparece.
¿Qué es un plugin de Codex?
Un plugin empaqueta capacidades para que se puedan instalar en un solo paso. Según la documentación de OpenAI, un plugin puede incluir:
- Skills, las instrucciones reutilizables que hemos descrito.
- Servidores MCP, que le dan a Codex herramientas nuevas, como acceso a GitHub, Slack o una app local.
- Extensiones de navegador para flujos de trabajo que necesitan capacidades del navegador.
- Hooks, comandos que se ejecutan en momentos concretos del runtime de Codex. Revísalos antes de confiar en ellos.
Los plugins se instalan desde el Plugins Directory, que comparten ChatGPT y Codex, o desde un marketplace, como un repositorio Git. En Codex CLI, ejecuta /plugins para explorarlos. Los plugins funcionan en Codex CLI y en Codex dentro de la app de escritorio de ChatGPT; la extensión para IDE no los admite. Abre una sesión nueva después de instalar para que se carguen las nuevas skills y herramientas.
Un ejemplo: cómo está hecho Codex Design
Codex Design es un plugin, y necesita las dos partes:
- Un servidor MCP añade las herramientas del lienzo: crear un lienzo, abrirlo y añadir o mover nodos de imagen y HTML. Sin ellas, Codex no tiene ningún lienzo en el que trabajar.
- Una skill explica cómo usar bien esas herramientas: abrir el lienzo antes de añadir pantallas, que cada archivo HTML sea autocontenido y dar a cada pantalla el tamaño de su dispositivo.
Una skill por sí sola podría describir un lienzo, pero no crearlo. Un servidor MCP por sí solo ofrecería las herramientas sin el saber hacer. El plugin trae las dos cosas con un solo comando de instalación. Consulta cómo instalar Codex Design.
¿Cuál deberías usar?
Escribe una skill cuando…
- El flujo de trabajo solo necesita herramientas que Codex ya tiene, como leer archivos y ejecutar comandos.
- Es específico de un proyecto, como la checklist de revisión de diseño de tu equipo.
- Quieres iterar rápido: basta con editar un archivo Markdown.
Crea o instala un plugin cuando…
- Codex necesita herramientas nuevas o acceso a otro servicio.
- Quieres agrupar varias skills que van juntas.
- Otras personas deben poder instalar todo el flujo de trabajo de una vez.
Preguntas frecuentes
¿Un plugin puede contener más de una skill?
Sí. Un plugin puede agrupar varias skills, junto con servidores MCP y otras piezas.
¿Las skills de Codex son lo mismo que las Agent Skills?
Las skills de Codex se basan en el formato abierto Agent Skills. Una skill escrita para otro agente que usa el mismo formato SKILL.md normalmente se puede copiar en .agents/skills y usar en Codex.
¿Cómo desactivo una skill sin borrarla?
Añade una entrada [[skills.config]] con la ruta de la skill y enabled = false a ~/.codex/config.toml y reinicia Codex.