Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Escrever uma competência reutilizável

Aula 17 de 17 Atualizada a 5 de novembro de 2026 Intermediario
Nesta página
  1. A anatomia de uma competência
  2. A descrição é a peça central
  3. Definições opcionais
  4. Onde vivem as competências e como partilhá-las
  5. A sua vez
  6. Pontos-chave
  7. Teste os seus conhecimentos

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 anatomia de uma competência Três blocos: SKILL.md, obrigatório, com o nome, descrição e instruções; a pasta references, opcional, para ficheiros de referência; a pasta scripts, opcional, para passos automatizados. UMA PASTA, UM FICHEIRO OBRIGATÓRIO A anatomia de uma competência 1 SKILL.md Nome, descrição, instruções. Obrigatório 2 references/ Ficheiros de referência. Opcional 3 scripts/ Passos automatizados. Opcional A descrição decide quando a competência é acionada: diga quando usar a competência e quando não a usar.
Baseado na página Build skills na documentação do ChatGPT (novembro de 2026).

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.