plugins: El catálogo oficial de OpenAI para ver cómo se arma un plugin de Codex que conecta con herramientas reales.

El catálogo oficial de OpenAI para ver cómo se arma un plugin de Codex que conecta con herramientas reales.

Cuando OpenAI publica el repo de ejemplos, define el estándar de facto. Aquí están más de 150 plugins de Codex con su manifiesto, skills y comandos, listos para leer y copiar. Es la referencia para entender cómo se conecta un agente con Figma, Notion, Linear o GitHub sin improvisar la estructura.

Estrellas

2.9k★

Lenguaje

JavaScript

De OpenAI

Oficial

Revisado

13 jun 2026

De un vistazo, lo que vas a obtener si lo instalas.

Estándar de facto

Publicado por OpenAI, así que define cómo se estructura un plugin de Codex bien hecho.

150+ integraciones

Figma, Notion, Linear, GitHub, Gmail, HubSpot, Datadog, Cloudflare y más, cada una como plugin de ejemplo.

Manifiesto claro

Cada plugin lleva su .codex-plugin/plugin.json y, opcional, carpetas de skills, agents, commands, hooks y MCP.

Plantillas de app

Plugins para construir apps de iOS y macOS con SwiftUI, web con bases de datos y pagos, y móvil con Expo.

Listo para copiar

La forma de usarlo es leer el plugin más parecido al tuyo y clonar el patrón, no instalar una dependencia.

El contexto detrás del repo.

Codex dejó de ser solo un autocompletado. El sistema de plugins le permite conectarse con herramientas externas a través de un manifiesto y componentes acompañantes (skills, agentes, comandos). El problema de cualquier estándar nuevo es que no sabes cómo se ve un plugin bien hecho hasta que ves varios. Este repo resuelve eso: es el catálogo curado por OpenAI con más de 150 ejemplos.

Cada plugin vive en `plugins/<nombre>/` con un manifiesto obligatorio en `.codex-plugin/plugin.json` y, opcionalmente, carpetas de `skills/`, `agents/`, `commands/`, un `.mcp.json` para servidores MCP, `hooks.json` y assets. La lista cubre integraciones que un equipo real usa todos los días: Figma, Notion, Linear, GitHub, Gmail, HubSpot, Datadog, Cloudflare, Asana, Intercom, además de plantillas para construir apps de iOS, macOS, web y React Native con Expo.

No es una librería que instalas y olvidas. Es material de referencia. La forma de usarlo es leer el plugin más cercano a lo que quieres conectar, entender cómo estructuraron el manifiesto y los skills, y copiar el patrón a tu propio plugin. El README oficial es deliberadamente escueto: el valor está en el código de cada carpeta, no en la documentación de portada.

Cuándo lo recomiendo (y cuándo no).

Lo recomiendo para cualquiera que esté construyendo un plugin de Codex o evaluando si vale la pena montar uno para su empresa. Si quieres que tu agente hable con Linear, con tu Notion o con tu cuenta de GitHub, aquí tienes el plugin de referencia escrito por gente que conoce el estándar desde adentro. Para un equipo que ya adoptó Codex como entorno de desarrollo, este repo acorta la curva de "cómo se arma esto bien" de días a horas.

Para quién no es: si solo quieres usar Codex sin extenderlo, no necesitas este repo. Y si tu agente es Claude Code, el estándar de plugins es distinto (los manifiestos viven en `.claude-plugin/`, no en `.codex-plugin/`); te sirve como inspiración de arquitectura, pero los archivos no son portables directo. Tampoco esperes documentación extensa: el README es mínimo a propósito.

En 3 pasos, listo para probar.

Clona el repo para leer los ejemplos

git clone https://github.com/openai/plugins.git
cd plugins/plugins

El valor está en leer el código. Abre la carpeta del plugin más cercano a lo que quieres conectar (por ejemplo linear o notion) y revisa su manifiesto.

Entiende la estructura de un plugin

plugins/<nombre>/
  .codex-plugin/plugin.json   # manifiesto obligatorio
  skills/                     # opcional
  agents/  commands/  hooks.json
  .mcp.json                   # opcional, para servidores MCP

El manifiesto en .codex-plugin/plugin.json es lo único obligatorio. Lo demás se agrega según lo que tu plugin necesite hacer.

Agrega el marketplace en Codex CLI

codex plugin marketplace add openai/plugins

Registra el catálogo como fuente en tu Codex CLI para usar los plugins de ejemplo directo. El README de portada es escueto; la referencia real es el código de cada carpeta.

Qué es un plugin de Codex aquí

El repo define una estructura estándar. Cada plugin vive en su propia carpeta dentro de plugins/ y se arma con un manifiesto más componentes opcionales:

Archivo / carpeta	Obligatorio	Para qué
`.codex-plugin/plugin.json`	Sí	Manifiesto que declara el plugin a Codex
`skills/`	No	Habilidades que el agente puede invocar
`agents/`	No	Agentes especializados del plugin
`commands/`	No	Comandos slash propios
`.mcp.json`	No	Conexión a servidores MCP externos
`hooks.json`	No	Hooks de ciclo de vida
`.app.json` / `assets/`	No	Metadatos y recursos visuales

Lo único que no es opcional es el manifiesto. Todo lo demás se suma según qué tan lejos quieras llevar el plugin: un wrapper simple de una API puede ser solo manifiesto más un skill; una integración seria con Figma trae skills de diseño, conexión de código y reglas de design system.

El catálogo cubre herramientas reales

La lista de plugins no son ejemplos de juguete. Son integraciones con software que un equipo de producto o ingeniería usa todos los días. Una muestra de lo que hay en el repo:

Diseño y producto: Figma, Canva, Notion, Linear, Asana, ClickUp, monday.com, Dovetail
Desarrollo: GitHub, CircleCI, Cloudflare, Convex, Netlify, Expo, Datadog
Comunicación y ventas: Gmail, Google Calendar, Intercom, HubSpot, Close, Attio
Plantillas de app: build-ios-apps, build-macos-apps, build-web-apps, build-web-data-visualization

Cada una sirve como punto de partida. Si vas a conectar tu agente con Linear, no empiezas de cero: lees el plugin de Linear, ves cómo estructuraron el manifiesto y los comandos, y adaptas.

Cómo usarlo de verdad

El README de portada es corto a propósito. No vas a encontrar un tutorial largo. La forma de aprovechar este repo es:

Identifica la herramienta que quieres conectar o el tipo de app que quieres construir.
Abre la carpeta del plugin más cercano.
Lee su plugin.json y sus skills para entender el patrón.
Copia la estructura a tu propio plugin y cámbiale lo específico de tu caso.

Es ingeniería por ejemplo, no por documentación. Para quien ya programa, suele ser más rápido que leer una guía.

Codex, no Claude Code

Conviene tenerlo claro para no perder tiempo: estos plugins son para Codex, con manifiesto en .codex-plugin/. Claude Code usa un estándar paralelo con manifiesto en .claude-plugin/. Los conceptos se traducen casi uno a uno (skills, comandos, agentes, hooks), pero los archivos no son intercambiables tal cual. Si tu equipo está en Claude Code, este repo te sirve como referencia de arquitectura, no como código que copias y pegas sin tocar.

Limitaciones honestas

Documentación mínima. El README no explica mucho; el aprendizaje está en leer las carpetas. Para alguien sin experiencia en plugins, la curva es más empinada de lo que parece.
Específico de Codex. No es portable directo a Claude Code ni a otros agentes. Sirve de inspiración, no de copia literal cross-plataforma.
Sin licencia declarada visible. A la fecha de esta ficha el repo no muestra un archivo de licencia claro en su metadata pública. Antes de reutilizar código en un producto comercial, revisa los términos en el repo. No asumas MIT.
Es referencia, no producto. No instalas esto y obtienes una funcionalidad terminada. Es material para construir lo tuyo.

Mi recomendación

Si estás construyendo sobre Codex o evaluando montar plugins para tu empresa, este es el primer lugar donde mirar, porque lo curó OpenAI y marca el estándar. Clónalo, abre el plugin de la herramienta que más te importe conectar y estudia cómo lo armaron. Te ahorra la fase de adivinar la estructura correcta. Solo no esperes documentación de la mano ni código portable a Claude Code, y verifica la licencia antes de meter algo de aquí en un producto que vendes.