Como criar uma skill para GPT Work e baixar em SKILL.md

Comece pela tarefa, não pela ferramenta

Uma skill útil descreve uma tarefa que se repete e que precisa de um padrão. Relatório semanal, revisão de código, análise de documentos e triagem de incidentes são exemplos melhores do que uma instrução vaga como seja mais inteligente.

Defina o resultado e o momento de ativação antes de escolher conexões. Isso evita criar uma skill que pede acesso a GitHub, navegador ou API sem realmente precisar deles.

Escreva uma descrição que ajude o agente a escolher

A descrição precisa dizer o que a skill faz e quando ela deve ser usada. Se a frase for genérica demais, o agente pode ativá-la na hora errada. Se for específica demais, a skill não será encontrada quando deveria.

Use palavras que uma pessoa realmente colocaria no pedido. Depois teste com exemplos que devem ativar a skill e exemplos parecidos que devem ficar de fora.

• Nomeie a tarefa com letras minúsculas e hífens.
• Descreva o resultado e o gatilho em uma frase.
• Liste entre três e oito etapas observáveis.
• Explique o formato de saída e os limites.

Conexões devem ser declarações, não segredos

Uma skill pode declarar que precisa de web, GitHub, arquivos, terminal, navegador, API ou MCP. Isso não significa que ela deve guardar uma chave ou executar qualquer ferramenta automaticamente.

As credenciais pertencem ao ambiente autorizado. No gerador do Caiu ou Não?, as conexões vão para um arquivo declarativo separado, sem tokens, cookies ou senhas.

Revise antes de baixar e instalar

O pacote gerado contém SKILL.md, README e connections.json. Leia o texto, ajuste os passos para o seu agente e faça um teste com dados fictícios. O formato Agent Skills é portátil, mas campos e permissões podem variar entre produtos.

Se a skill executar código, acessar dados pessoais, navegar, publicar ou alterar produção, inclua uma etapa explícita de confirmação. Uma skill bem escrita reduz ambiguidade, mas não substitui controle de acesso ou revisão humana.

Fontes consultadas

Os links abaixo servem para conferir conceitos, orientações oficiais e o critério editorial usado neste conteúdo.

• Agent Skills SpecificationAgent Skills
• Public repository for Agent SkillsAnthropic
• Usar o Codex com o ChatGPTOpenAI Help Center