Treinar um agente de IA Skill (SKILL.md)
- Configurar um novo agente
- Repassar uma tarefa recorrente
- Ajustar resultados fracos
- O que este skill faz?
- Cria um briefing de integração para um agente de IA: objetivo mensurável, contexto e regras, exemplos de bom trabalho e um ciclo de feedback.
- O que você fornece?
- Tema, objetivo e alguns tópicos.
- O que você recebe?
- Briefing de integração com papel e propósito
- Objetivo SMART com critério de conclusão
- Contexto e regras
- Exemplos de bom trabalho
- Checklist para a rodada de feedback
- Funciona em
- Claude, ChatGPT, Gemini, Microsoft 365 Copilot, Cursor e outros assistentes
Instruções do skill
É assim que a IA trabalha com este skill. Copie ou adicione como arquivo ao seu assistente.
- Pergunte pela tarefa, para quem é o resultado e com que frequência ela acontece.
- Formule um objetivo SMART: concreto, mensurável, alcançável, relevante e com prazo ou ritmo. Acrescente como o agente sabe que terminou.
- Reúna o contexto: propósito, público, tom, fontes permitidas e termos que o agente precisa conhecer.
- Registre regras e limites: o que o agente nunca faz, quando pergunta e quais etapas uma pessoa aprova.
- Peça um ou dois exemplos reais de bom trabalho e descreva o que os torna bons. Se faltarem, marque o ponto com [incluir exemplo].
- Planeje o ciclo de feedback: comparar os primeiros resultados com o objetivo, anotar desvios e ajustar as instruções.
Ver o texto completo
--- name: agent-onboarding description: "Cria um briefing de integração para um agente ou assistente de IA. Use antes de repassar uma tarefa recorrente a um agente." license: "Uso livre, inclusive no trabalho; não publicar como coleção própria. Termos de uso do AI Compare Ninja." --- # Treinar um agente de IA Você ajuda a integrar um agente de IA como uma colega nova: com um objetivo verificável, o contexto necessário e exemplos de bom trabalho. ## Passos 1. Pergunte pela tarefa, para quem é o resultado e com que frequência ela acontece. 2. Formule um objetivo SMART: concreto, mensurável, alcançável, relevante e com prazo ou ritmo. Acrescente como o agente sabe que terminou. 3. Reúna o contexto: propósito, público, tom, fontes permitidas e termos que o agente precisa conhecer. 4. Registre regras e limites: o que o agente nunca faz, quando pergunta e quais etapas uma pessoa aprova. 5. Peça um ou dois exemplos reais de bom trabalho e descreva o que os torna bons. Se faltarem, marque o ponto com [incluir exemplo]. 6. Planeje o ciclo de feedback: comparar os primeiros resultados com o objetivo, anotar desvios e ajustar as instruções. ## Resultado - Briefing de integração com papel e propósito - Objetivo SMART com critério de conclusão - Contexto e regras - Exemplos de bom trabalho - Checklist para a rodada de feedback ## Regras - Não invente números, fatos nem exemplos; marque pendências como [esclarecer]. - Nada de credenciais ou senhas no briefing. - Enviar, apagar ou pagar só com aprovação humana. - Não invente fatos, números, nomes, datas ou compromissos. Se faltar algo, escreva [falta: …] ou pergunte. - Responda no idioma de quem está usando, salvo pedido diferente. - Repita apenas os dados pessoais que a tarefa exigir. - Você entrega um rascunho. A decisão e o envio ficam com a pessoa. Uso: livre, inclusive no trabalho · não publicar como coleção própria · Fonte: AI Compare Ninja
Como arquivo: Baixar (ZIP)
Instalar no Claude
- No Claude, abra Settings e ative “Code execution and file creation” em “Capabilities”.
- Vá em “Customize” › “Skills”.
- Clique em “+”, depois em “Create skill” e “Upload a skill”.
- Escolha o ZIP baixado. A skill aparece na sua lista, onde você pode ativá-la e desativá-la.
O ZIP contém a pasta “agent-onboarding” com o arquivo SKILL.md, exatamente como o Claude espera. Não descompacte; envie o arquivo como está.
Claude Code: descompacte o arquivo em ~/.claude/skills/ (para você) ou em .claude/skills/ no seu projeto.
Passos conforme a ajuda da Anthropic, outubro de 2026. Os nomes de menu são da interface em inglês e podem mudar em outros idiomas ou após atualizações. Em contas Team e Enterprise, a administração precisa liberar as skills. Fontes: https://support.claude.com/en/articles/12512180-use-skills-in-claude · https://claude.com/docs/skills/how-to
Usar no ChatGPT, Gemini e Copilot
ChatGPT: em workspaces Business, Enterprise e Edu, você envia o arquivo como skill se a administração permitir. App Gemini: skills podem ser enviadas como SKILL.md ou ZIP. Microsoft 365 Copilot: envie como skill própria no Cowork. Codex, GitHub Copilot e Cursor leem skills da pasta do projeto .agents/skills/. Em qualquer outro lugar, cole o texto como instruções em um projeto do ChatGPT ou do Claude ou no início de um chat.
Segundo as páginas de ajuda dos fabricantes, outubro de 2026. A disponibilidade depende do plano, da administração, da idade e da região. Fontes: https://help.openai.com/en/articles/20001066-skills-in-chatgpt · https://support.google.com/gemini/answer/17094296 · https://learn.microsoft.com/en-us/microsoft-365/copilot/cowork/cowork-customize · https://developers.openai.com/codex/skills · https://code.visualstudio.com/docs/copilot/customization/agent-skills · https://cursor.com/docs/context/skills
Uso, segurança e avisos
Só texto, revisado por nós. Esta skill não contém scripts, links nem chamadas a outros serviços. Ela pede à IA que não invente nada e deixe a decisão final com você.
Resultados de IA podem estar errados ou incompletos. Confira antes de usar ou enviar. Não é consultoria jurídica, tributária, financeira ou médica. Sem garantia.
Não insira senhas, dados de saúde, bancários ou de documentos, nem dados pessoais de outras pessoas em ferramentas de IA. O que você digita é tratado por cada fornecedor conforme os próprios termos.
Você pode usar e adaptar nossas skills livremente, inclusive no trabalho. Não as publique como coleção própria. Não damos garantia sobre resultados de IA; confira-os você mesmo. Termos de uso