Para crear o enviar un complemento, consulta la documentación completa para desarrolladores en developers.openai.com.
Esta página ofrece una breve introducción. Un complemento es un paquete instalable que puede incluir habilidades, un servidor MCP o ambos. Un servidor MCP también puede devolver una interfaz de usuario opcional.
ChatGPT y Codex comparten un único directorio universal de complementos. Publica un complemento público una sola vez para que la misma ficha se pueda encontrar en las interfaces compatibles de ambos productos. Durante el desarrollo, usa un Marketplace local para probar el paquete antes de enviarlo al directorio universal.
Para distribuir complementos en un espacio de trabajo a través de GitHub, consulta Administración de complementos.
Empieza con una habilidad mientras sigues perfeccionando un flujo de trabajo personal. Crea un complemento cuando quieras compartir ese flujo de trabajo, empaquetar habilidades relacionadas, conectarte a un servicio externo o distribuir una capacidad estable a un equipo.
Crear un complemento con @plugin-creator
Para completar la configuración lo más rápido posible, usa la habilidad integrada @plugin-creator en el modo Work
de ChatGPT o $plugin-creator en Codex.
Describe el resultado esperado, las habilidades o el servidor MCP que se incluirán y si quieres una entrada en un Marketplace local para hacer pruebas. Por ejemplo:
@plugin-creator Create a plugin named meeting-follow-up.
Include a skill that turns meeting notes into decisions, owners, and next steps.
Add it to a personal marketplace so I can test it locally.
La habilidad crea un archivo de manifiesto de compatibilidad .codex-plugin/plugin.json
en un formato admitido, organiza la carpeta del complemento y puede agregarlo a un Marketplace
local. Esta estructura inicial difiere del formato portátil con plugin.json en la raíz
que se usa en el ejemplo manual. Consulta la estructura inicial
para conocer los archivos y directorios opcionales.
Cuando termine:
- Revisa
.codex-plugin/plugin.json. - Revisa cada habilidad incluida en
skills/. - Recarga ChatGPT o Codex e instala el complemento desde su fuente en el Marketplace local.
- Prueba el complemento en una conversación nueva con solicitudes representativas.
Si el complemento incluye un servidor MCP, primero crea y prueba ese servidor y luego
proporciona a @plugin-creator los detalles de la conexión registrada. Sigue el
flujo de trabajo completo del servidor MCP
para las herramientas, la autenticación, el despliegue y las pruebas.
Crear manualmente un complemento que solo incluya habilidades
Un paquete portátil mínimo de Agent Plugins contiene un archivo de manifiesto en la raíz y al menos una habilidad:
meeting-follow-up/
├── plugin.json
└── skills/
└── meeting-follow-up/
└── SKILL.md
Crea plugin.json en la raíz del complemento:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "meeting-follow-up",
"version": "1.0.0",
"description": "Turn meeting notes into decisions and next steps"
}
Los paquetes portátiles detectan automáticamente las habilidades en skills/. Agrega
skills/meeting-follow-up/SKILL.md:
---
name: meeting-follow-up
description: Extract decisions, owners, and next steps from meeting notes.
---
Review the meeting notes. Return:
1. Decisions
2. Action items with owners
3. Open questions
Usa un nombre estable en kebab case para el complemento. La descripción de la habilidad debe ser lo suficientemente específica para que ChatGPT y Codex reconozcan cuándo corresponde usar el flujo de trabajo.
Usa @plugin-creator para agregar la carpeta a un Marketplace local; luego instala y
prueba el complemento antes de compartirlo.
Continuar con la documentación para desarrolladores
Para acceder a la documentación completa para desarrolladores, consulta la documentación de complementos. Abarca estos temas:
- Arquitectura de los complementos
- Crear habilidades
- Crear un servidor MCP
- Agregar una interfaz de usuario opcional
- Empaquetar un complemento
- Probar un complemento
- Enviar y publicar
Para explorar, instalar, habilitar o eliminar complementos, consulta Usar complementos.