Codex ofrece tres formas de ampliar un agente: skills que recogen tu proceso, servidores MCP que llegan a sistemas en vivo y plugins que empaquetan ambos para un equipo. Este artículo muestra cómo se ve cada uno en disco, cuánto cuesta en contexto y cómo elegir entre ellos.
Abre el explorador de plugins de Codex y verás skills, servidores MCP y plugins listados uno al lado del otro, como si fueran tres versiones de lo mismo. No lo son. Confundirlos es la forma en que alguien acaba escribiendo un archivo de instrucciones de 400 líneas cuando necesitaba un conector de diez líneas, o montando un servidor cuando bastaba una lista de comprobación de una página.
Aquí va la versión corta antes de los detalles. Una skill enseña a Codex cómo hacer un trabajo. Un servidor MCP le da acceso en vivo a una herramienta o a una fuente de datos. Un plugin es la caja que reúne skills, servidores y conexiones con aplicaciones para que otra persona los instale en un solo paso. El resto de este artículo muestra cómo se ve cada uno en disco, cuánto cuesta en contexto, dónde falla y cómo elegir el adecuado para tu propio trabajo.
Tres objetos sobre una misma mesa de trabajo facilitan recordar la diferencia. La llave es una herramienta a la que recurres. La carpeta te dice cómo ejecutar un trabajo. La caja es un paquete que alguien preparó para entregárselo a un compañero.
SKILL.md que le indica a Codex cuándo y cómo ejecutar un flujo de trabajo repetible.Ninguno reemplaza a los demás. Un plugin no es una cuarta clase de capacidad. Es el empaquetado de las dos primeras, más las conexiones con aplicaciones, con un número de versión.
Una skill es una tarjeta de receta: pasos ordenados, cantidades y una descripción de lo que significa "terminado". Un servidor MCP es un electrodoméstico conectado a la pared: hace cosas que el cocinero no puede hacer a mano, como batir o refrigerar. Un plugin es el kit de comida: la tarjeta, los ingredientes y una nota sobre qué electrodoméstico necesitas, todo en una misma caja.
💡 Regla general: si el problema es "Codex no conoce nuestro proceso", escribe una skill. Si es "Codex no puede llegar a ese sistema", añade un servidor MCP. Si es "mis compañeros no paran de preguntarme cómo lo configuré", crea un plugin.
El Model Context Protocol es un estándar abierto, presentado por Anthropic a finales de 2024, que permite a un cliente de IA hablar con herramientas externas a través de una interfaz común. Codex hace de cliente. El servidor es aquello a lo que lo apuntes: un conector de GitHub, un puente a una base de datos, una búsqueda de documentación o un generador de imágenes.
Un servidor MCP responde a una pregunta: qué puedes hacer ahora mismo y con qué datos. Lista herramientas con nombres, descripciones y esquemas de entrada. Cuando Codex decide que una herramienta encaja con la tarea, la llama y lee el resultado. Nada en el servidor dice cómo prefiere tu equipo usarla. Un servidor de base de datos ejecutará cualquier consulta que permitas, pero no le dirá a Codex que nadie toca las tablas de facturación un viernes por la tarde.
Esa brecha es la razón por la que servidores y skills combinan tan bien. El servidor aporta el alcance. La skill aporta el criterio.
Codex guarda los ajustes de MCP en ~/.codex/config.toml, y es posible tener ajustes con alcance de proyecto en .codex/config.toml. Un servidor local que Codex inicia por sí mismo (STDIO) se ve así:
[mcp_servers.docs]
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
Un servidor remoto mediante streamable HTTP usa una URL en su lugar:
[mcp_servers.figma]
url = "https://mcp.figma.com/mcp"
bearer_token_env_var = "FIGMA_OAUTH_TOKEN"
También puedes ejecutar codex mcp add <name> -- <command> para que escriba la entrada por ti, codex mcp list para ver qué está configurado y codex mcp login <server-name> para ejecutar OAuth en los servidores que lo necesitan.
Algunos ajustes merecen atención. startup_timeout_sec tiene 10 segundos por defecto, lo que puede resultar justo para una primera descarga lenta de npx. tool_timeout_sec tiene 60 segundos por defecto, lo que cortará trabajos largos como el render de un video. enabled_tools y disabled_tools te permiten recortar un servidor hasta las llamadas que realmente quieres que vea el agente.
Los costos de MCP son reales. Cada servidor conectado añade definiciones de herramientas que el modelo debe cargar, un proceso o un salto de red que puede fallar y un nuevo límite de confianza. Un servidor que puede escribir en tu repositorio también puede escribir algo que no pretendías.
Una skill es una carpeta. Dentro hay un archivo SKILL.md que empieza con una cabecera YAML breve, entre dos líneas de separación al principio del archivo. La cabecera contiene un name y una description:
name: release-notes
description: Use when the user asks for release notes or a changelog built from merged pull requests. Do not use for commit message drafts.
Debajo de la cabecera, las instrucciones son markdown sencillo:
1. List the pull requests merged since the last tag.
2. Group them under Added, Changed and Fixed.
3. Write one plain sentence per item.
4. Save the result to docs/releases/<version>.md.
La carpeta también puede contener scripts, documentos de referencia, plantillas y recursos a los que apuntan las instrucciones. Codex busca skills en .agents/skills dentro del repositorio (el directorio de trabajo, sus padres y la raíz del repo), en $HOME/.agents/skills para las skills personales, en /etc/codex/skills para las compartidas de toda la máquina y en el conjunto integrado que incluye Codex.
Las skills usan una divulgación progresiva. Al inicio de una sesión, Codex solo ve la lista de nombres y descripciones de las skills, y esa lista se limita a alrededor del 2% de la ventana de contexto (u 8000 caracteres cuando se desconoce el tamaño de la ventana). El SKILL.md completo se carga solo después de que se seleccione una skill. Funciona como un catálogo de fichas: lees las fichas hasta encontrar el cajón correcto y luego sacas el archivo entero.
La consecuencia es práctica. Puedes tener decenas de skills instaladas sin pagar por todas en cada petición. Y también significa que la línea description hace el trabajo pesado. Una descripción vaga como "ayuda con la documentación" nunca se activa. Una precisa, que diga cuándo usar la skill y cuándo no, se activa de forma fiable.
Hay dos formas de ejecutar una skill. Explícita: escribe $release-notes en la CLI de Codex o en la extensión del IDE (ChatGPT usa @release-notes). Implícita: Codex elige la skill por su cuenta cuando tu petición coincide con la descripción. Un archivo agents/openai.yaml opcional ajusta cómo aparece la skill en la interfaz, su política de invocación y las herramientas de las que depende.
💡 Si una skill nunca se activa sola, reescribe la descripción antes que las instrucciones. La descripción es el disparador.
El soporte de plugins llegó a Codex en marzo de 2026, y el lanzamiento inicial de más de 20 plugins incluyó Box, Figma, Linear, Notion, Sentry, Slack, Gmail y Hugging Face. La razón de ser de los plugins es la distribución. Una skill se puede copiar en una carpeta y un servidor se puede pegar en un archivo de configuración, pero pasarle ambos a diez compañeros con versiones coincidentes es tedioso y fácil de equivocar.
my-plugin/
plugin.json
mcp.json
skills/
release-notes/
SKILL.md
hooks/
assets/
scripts/
plugin.json en la raíz es el manifiesto, y .codex-plugin/plugin.json sigue funcionando como alternativa. Contiene el name en kebab case, una version, una description y los datos del autor. Las skills van en skills/<skill-name>/SKILL.md y se detectan desde esa carpeta sin necesidad de declararlas. Los servidores MCP van en mcp.json bajo mcpServers, con "type": "streamable-http" para los endpoints remotos. Los hooks ejecutan comandos en puntos determinados del ciclo de vida.
Para probarlo en local, añade una entrada cuyo source.path apunte a tu carpeta a un archivo de marketplace en ~/.agents/plugins/marketplace.json o $REPO_ROOT/.agents/plugins/marketplace.json, y luego instálalo desde el directorio de plugins. El asistente @plugin-creator puede crear la carpeta y la entrada del marketplace por ti.
En la CLI de Codex, ejecuta /plugins para abrir el explorador de plugins e instalar desde los marketplaces que hayas configurado. En la aplicación de escritorio de ChatGPT o en la web, abre la pestaña Plugins, busca, pulsa el botón con el signo más y conecta cualquier servicio externo cuando se te pida. Después puedes pedirlo en lenguaje natural ("Resume los hilos no leídos de Gmail de hoy") o escribir @ seguido del nombre del plugin para llamarlo de forma explícita.
Un plugin también añade un manifiesto, una versión que mantener y una entrada en el marketplace. Si eres la única persona que usa ese flujo de trabajo, una skill en $HOME/.agents/skills y un bloque en config.toml hacen el mismo trabajo con menos trámites.
💡 La documentación de Codex cambia rápido. Los nombres de archivo y los comandos de arriba siguen las páginas de OpenAI sobre plugins, MCP y skills a fecha de octubre de 2026. Compruébalos antes de construir.
| Skill | Servidor MCP | Plugin | |
|---|---|---|---|
| Qué es | Carpeta con SKILL.md | Servicio de herramienta o datos en ejecución | Paquete instalable |
| Le da a Codex | Un procedimiento | Alcance en vivo y acciones | Ambos, más conexiones con aplicaciones |
| Vive en | .agents/skills | config.toml | plugin.json y mcp.json |
| Se carga | Nombre y descripción primero, cuerpo bajo demanda | Definiciones de herramientas al conectar | Lo que incluya |
| Necesita código | No | Sí, o un servidor alojado | Solo si incluye un servidor |
| Ideal para | Proceso repetible de equipo | Sistemas a los que Codex no puede llegar | Compartir una configuración completa |
| Riesgo principal | Una descripción vaga nunca se activa | Permisos demasiado amplios | Desfase de versiones, servidores incluidos sin que se vean |
Las skills son las más baratas de las tres, porque solo una descripción corta ocupa contexto hasta que se necesita la skill. Un servidor MCP pesa más: su lista de herramientas se mete en la sesión lo use o no la tarea, así que diez servidores muy habladores pueden desplazar el trabajo real. Un plugin hereda el costo de todo lo que contiene.
Un hábito ahorra muchos tokens. Antes de añadir un servidor, pregúntate si una skill con un script corto podría hacer lo mismo. Los scripts dentro de una skill solo se ejecutan cuando se ejecuta la skill. Un servidor permanece conectado todo el tiempo.
Una skill es texto más scripts opcionales, así que su peligro está en los comandos que las instrucciones le indican a Codex que ejecute. Un servidor es un proceso en vivo con sus propias credenciales, lo que convierte los permisos en la principal preocupación. Recórtalos con enabled_tools y disabled_tools, y usa default_tools_approval_mode para decidir cuánto puede hacer Codex sin preguntar.
Un plugin puede incluir servidores, skills y hooks a la vez, así que abre plugin.json, mcp.json y la carpeta de hooks antes de instalar uno de un desconocido. Guarda los tokens en variables de entorno, tal como espera bearer_token_env_var, y nunca en un archivo que subas al repositorio.
AGENTS.md.Cuando no estés seguro, empieza por la opción más pequeña y sube. Empieza con un prompt. Si lo repites tres veces, conviértelo en una skill. Si la skill necesita un sistema al que Codex no puede llegar, añade un servidor. Si otras personas necesitan la misma pareja, envuélvela en un plugin.
Meter el proceso dentro de un servidor. Las descripciones de las herramientas sirven para explicar qué hace una herramienta, no cómo trabaja tu equipo. Un texto largo de políticas dentro de un servidor infla cada sesión. Muévelo a una skill.
Reconstruir un conector con scripts de shell. Si ya existe un servidor MCP mantenido para el sistema que quieres, una skill llena de comandos curl será más lenta de escribir y más difícil de mantener funcionando.
Empaquetar demasiado pronto. Un plugin con un solo autor y un solo usuario es sobrecarga. Espera a que una segunda persona pida tu configuración.
Imagina un pequeño equipo de marketing que necesita fotos de blog coherentes. Las tres piezas se separan con limpieza. La skill, llamémosla brand-photos, guarda las reglas: 16:9 para las imágenes de artículos, luz natural, sin texto dentro de la imagen, un patrón de nombres de archivo y quién aprueba el conjunto final. El servidor MCP hace la generación en sí. El plugin entrega ambos a cada compañero para que nadie tenga que editar un archivo de configuración a mano.
PicassoIA ofrece una API para desarrolladores en api.picassoia.com/v1 y un conector MCP para sus modelos de imagen y video, incluidos PicassoIA Image y PicassoIA Image Editor Pro. Eso deja disponible hoy la parte de servidor de este patrón. Los detalles de conexión están en tu cuenta, así que confirma que tu cliente admite el conector antes de conectarlo.
La skill, después, le indica a Codex cómo aprovechar bien ese alcance: qué estructura de prompt seguir, qué relación de aspecto pedir y cuándo parar para preguntar a una persona. El servidor nunca necesita saber nada de eso.
No tienes que escribir a mano el primer SKILL.md. Un modelo de programación como GPT 5.6 Sol o Claude Sonnet 5 puede producir un borrador en segundos.
.agents/skills/brand-photos/SKILL.md.$brand-photos y una petición real. Si Codex no la detecta por sí solo, afina la descripción y vuelve a intentarlo.💡 Trata la salida del modelo como un primer borrador. Una skill solo es tan buena como las comprobaciones que añadas después de ver cómo se ejecuta en una tarea real.
Las skills, los servidores y los plugins se juzgan mejor cuando ves lo que producen. Abre PicassoIA y recrea las fotos de este artículo: un escritorio de roble de un desarrollador a la hora dorada, un rollo de herramientas de lienzo junto a una pila de fichas y una caja kraft preparada para enviar. Empieza con PicassoIA Image, cambia un detalle en cada ejecución, como la lente, la dirección de la luz o la textura de la superficie, y observa cómo cambia la imagen.
Luego pregúntate qué necesitó la segunda ejecución que la primera no tuvo. ¿Era una regla que repites una y otra vez? Esa es una skill esperando a escribirse. ¿Era un sistema que tuviste que abrir a mano? Eso es un servidor. ¿Era una configuración que quieres pasarle a un amigo? Eso es un plugin. Prueba algunos prompts en PicassoIA hoy y deja que tu propio flujo de trabajo te diga cuál necesitas.
Elige tu idioma
