Para criar ou enviar um plug-in, consulte a documentação completa para desenvolvedores em developers.openai.com.
Esta página oferece uma breve introdução. Um plug-in é um pacote instalável que pode incluir habilidades, um servidor MCP ou ambos. Um servidor MCP também pode retornar uma interface opcional.
ChatGPT e Codex compartilham um único diretório universal de plug-ins. Publique um plug-in público uma única vez para que a mesma listagem possa ser encontrada nas interfaces compatíveis dos dois produtos. Durante o desenvolvimento, use um marketplace local para testar o pacote antes de enviá-lo ao diretório universal.
Para distribuir plug-ins no workspace pelo GitHub, consulte Gerenciamento de plug-ins.
Comece com uma habilidade enquanto ainda estiver aprimorando um fluxo de trabalho pessoal. Crie um plug-in quando quiser compartilhar esse fluxo de trabalho, agrupar habilidades relacionadas, conectar-se a um serviço externo ou distribuir uma capacidade estável para uma equipe.
Criar um plug-in com @plugin-creator
Para configurar mais rapidamente, use a habilidade integrada @plugin-creator no modo Work
do ChatGPT ou $plugin-creator no Codex.
Descreva o resultado desejado, as habilidades ou o servidor MCP a incluir e informe se deseja uma entrada em um marketplace local para testes. Por exemplo:
@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.A habilidade cria um manifesto de compatibilidade .codex-plugin/plugin.json em um formato aceito,
organiza a pasta do plug-in e pode adicioná-lo a um
marketplace local. Essa estrutura inicial difere do formato portátil com plugin.json na raiz
usado no exemplo manual. Consulte a organização da estrutura inicial
para conhecer os arquivos e diretórios opcionais.
Após a conclusão:
- Revise
.codex-plugin/plugin.json. - Verifique cada habilidade incluída em
skills/. - Recarregue o ChatGPT ou o Codex e instale o plug-in a partir de sua origem no marketplace local.
- Teste o plug-in em uma nova conversa com solicitações representativas.
Se o plug-in incluir um servidor MCP, primeiro crie e teste esse servidor e depois
forneça a @plugin-creator os detalhes da conexão registrada. Siga o
fluxo de trabalho completo para servidores MCP
para configurar ferramentas, autenticação, implantação e testes.
Criar manualmente um plug-in apenas com habilidades
Um pacote portátil mínimo do formato Agent Plugins contém um manifesto na raiz e pelo menos uma habilidade:
meeting-follow-up/
├── plugin.json
└── skills/
└── meeting-follow-up/
└── SKILL.mdCrie plugin.json na raiz do plug-in:
{
"$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"
}Pacotes portáteis detectam automaticamente as habilidades em skills/. Adicione
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 questionsUse um nome estável em kebab case para o plug-in. Mantenha a descrição da habilidade específica o suficiente para que o ChatGPT e o Codex reconheçam quando o fluxo de trabalho se aplica.
Use @plugin-creator para adicionar a pasta a um marketplace local. Em seguida, instale e
teste o plug-in antes de compartilhá-lo.
Continue com a documentação para desenvolvedores
Para acessar a documentação completa para desenvolvedores, consulte a documentação de Plug-ins. Ela abrange:
- Arquitetura de plug-ins
- Criação de habilidades
- Criação de um servidor MCP
- Adição de uma interface opcional
- Empacotamento de um plug-in
- Testes de um plug-in
- Envio e publicação
Para explorar, instalar, ativar ou remover plug-ins, consulte Usar plug-ins.