Escrever uma competência reutilizável
Nesta página
Se as instruções de um GPT são o seu coração, a competência (skill) é o coração de um plugin. É o formato que utiliza para escrever um fluxo de trabalho reutilizável: instruções, recursos e scripts, se necessário. As competências da OpenAI seguem um padrão aberto chamado «agent skills» (agentskills.io), o que significa que uma competência bem escrita não fica bloqueada numa única ferramenta. Esta lição ensina-o a escrever uma.
A anatomia de uma competência
Uma competência é uma pasta que contém um ficheiro obrigatório, SKILL.md, e elementos opcionais.
synthese-document/
├── SKILL.md ← obrigatório: instruções + metadados
├── scripts/ ← opcional: código executável
├── references/ ← opcional: documentação
├── assets/ ← opcional: modelos, recursos
└── agents/
└── openai.yaml ← opcional: aparência e dependências
O ficheiro SKILL.md deve incluir um name e uma description. Eis um exemplo mínimo:
---
name: synthese-document
description: Summarizes a provided document into three parts (overview, key points, open questions). Use when the user requests a summary or report of an attached document.
---
# Document Summary
1. Read the entire document before writing.
2. Write three sections: Overview (3 sentences), Key Points (max 5 bullets), Open Questions.
3. Rely only on the document; if information is missing, write "not provided."
4. Use the template in `assets/modele.md` for formatting.
A descrição é a peça central
O ChatGPT e o Codex ativam uma competência de duas formas. Ou a invoca explicitamente — escrevendo @ no ChatGPT, ou /skills e $ no Codex — ou a ferramenta seleciona-a automaticamente quando o seu pedido corresponde à sua descrição. É por isso que a documentação enfatiza este campo: precisa de uma descrição concisa que comece pelo caso de uso principal e pelas palavras-chave de ativação, e que declare claramente os seus limites.
Um mecanismo específico impõe este requisito: a divulgação progressiva. Inicialmente, o ChatGPT e o Codex leem apenas o nome e a descrição de cada competência instalada; carregam as instruções completas do SKILL.md apenas quando utilizam efetivamente a competência. Isto permite-lhe instalar muitas competências sem sobrecarregar o contexto, mas também significa que uma descrição vaga leva a uma competência que nunca é escolhida na altura certa — ou que é escolhida na altura errada.
Definições opcionais
O ficheiro agents/openai.yaml permite-lhe polir a exibição na aplicação de ambiente de trabalho (nome, descrição curta, ícones, cor, prompt predefinido), declarar as ferramentas das quais a competência depende — um servidor MCP, por exemplo — e definir uma política de invocação. Definir allow_implicit_invocation: false impede o ChatGPT de escolher a competência por si próprio: útil para fluxos de trabalho sensíveis que deseja acionar apenas sob demanda.
Onde vivem as competências e como partilhá-las
Uma competência autónoma funciona na aplicação de ambiente de trabalho do ChatGPT, no Codex via linha de comandos e na sua extensão de editor; no Codex, as competências de projeto vão para a pasta .agents/skills do repositório. Para tornar uma competência disponível para outros, a OpenAI recomenda empacotá-la num plugin: um plugin pode agrupar várias competências e adicionar ligações a servidores MCP ou elementos de apresentação. As competências incluídas num plugin tornam-se então disponíveis nos modos Chat e Work no ChatGPT, na web, no ambiente de trabalho e no telemóvel. No ChatGPT na web, o separador Skills no diretório de plugins também permite criar uma competência via conversação (usando a competência integrada skill-creator), com um editor ou por importação, e partilhá-la dentro do seu espaço de trabalho; este separador está reservado aos planos elegíveis Business, Enterprise, Healthcare e Edu.
A sua vez
De GPT para competência. Pegue nas instruções do GPT que construiu nas lições 4 a 7. Transforme-as num SKILL.md: um nome curto, uma descrição que diga quando o usar e quando não o usar, passos numerados e os seus ficheiros de conhecimento armazenados em references/. Depois, teste a competência duas vezes: uma vez invocando-a com @, e outra com um pedido regular que a deva acionar.
Fontes oficiais: Build skills (documentação do ChatGPT: SKILL.md, descrição, localizações) · Skills in ChatGPT (Centro de Ajuda da OpenAI: separador Skills, planos, partilha)
Pontos-chave
- Uma competência é uma pasta com um
SKILL.md(nome + descrição obrigatórios) e recursos opcionais; segue o padrão aberto agent skills - A descrição decide quando a competência é escolhida: comece pelo caso de uso, palavras-chave de ativação e limites
- Divulgação progressiva: apenas o nome e a descrição são lidos primeiro; as instruções carregam no momento da utilização
- Para partilhar uma competência, empacote-a num plugin
Teste os seus conhecimentos
De GPTs para plugins: valide todo o percurso.
1. Custom Instructions, Memory, GPT: qual é a diferença?
Resposta: As Custom Instructions tingem todas as suas conversas; a Memory retém factos sobre si ao longo do tempo; um GPT é um assistente empacotado — instruções, conhecimento, ferramentas — partilhável com outros.
2. O que deve conter uma boa instrução de sistema de um GPT?
Resposta: O papel, o âmbito (o que faz e o que não faz), o tom, o formato da resposta e o tratamento de casos extremos — escrito como uma descrição de posto de trabalho, não como uma lista de desejos.
3. Para que serve a base de conhecimento?
Resposta: Para fornecer ao GPT documentos de referência que consulta para responder — os seus guias, catálogos ou procedimentos, em vez de depender apenas da sua memória de treino.
4. O que acontece às ações de um GPT ao migrar para um plugin?
Resposta: Não são transferidas: deve verificar se já existe uma aplicação no diretório de plugins, caso contrário, reconstrua a integração, por exemplo com um servidor MCP. As instruções tornam-se uma competência e a base de conhecimento torna-se ficheiros de referência.
5. Antes de partilhar um GPT ou plugin, o que deve verificar?
Resposta: Testes em casos reais e casos extremos, conformidade com as políticas de utilização, clareza da descrição, uma política de privacidade para qualquer ação pública e garantir que não há dados sensíveis ocultos nas instruções ou ficheiros.
Uma ferramenta partilhada compromete o seu criador: teste como se os seus utilizadores já lá estivessem e migre os seus GPTs antes de 11 de dezembro de 2026.