Agent Skills: o que são skills de agentes de IA e por que importam

Agent Skills é um padrão aberto para ensinar agentes de IA a executar tarefas do mesmo jeito sempre. Uma skill é uma pasta com um arquivo chamado SKILL.md, que traz um nome, uma descrição e as instruções, podendo incluir scripts e materiais de apoio, segundo a documentação oficial do padrão.

A novidade de outubro de 2026 é institucional: a Anthropic, que criou o formato, anunciou em 22/10/2026 a doação do padrão a uma fundação neutra. Para quem usa IA no dia a dia, isso importa porque a mesma skill pode servir a vários agentes. Este guia explica a ideia sem jargão, mostra um exemplo prático e aponta os cuidados. Se você ainda se confunde com os termos, comece pelo texto sobre a diferença entre agente de IA, chatbot e automação.

O que é uma skill de agente de IA

Pense numa skill como uma receita de procedimento que o agente consulta quando precisa. Em vez de repetir a mesma explicação toda vez ("quando eu pedir um orçamento, siga estes passos, use este tom, entregue neste formato"), você escreve uma vez e guarda numa pasta. O agente decide sozinho quando usá-la, a partir da descrição.

A estrutura mínima é simples. Uma pasta com o nome da skill e, dentro dela, o arquivo SKILL.md. Opcionalmente entram três subpastas: scripts, para código que o agente pode executar; references, para documentos de consulta; e assets, para modelos e imagens. A ideia é parecida com o que já existe para pessoas, e quem já documentou processos com o guia de procedimento operacional padrão com IA vai reconhecer o raciocínio: escrever o passo a passo para que qualquer um, humano ou máquina, refaça igual.

Como o agente usa a skill sem encher a memória

O ponto técnico mais interessante se chama divulgação progressiva. A especificação descreve três estágios. No primeiro, ao iniciar, o agente carrega apenas o nome e a descrição de cada skill disponível, algo em torno de 100 tokens por skill. No segundo, quando a tarefa combina com a descrição, ele lê o SKILL.md inteiro. No terceiro, só se precisar, abre scripts e arquivos de referência.

Na prática, isso resolve um problema que muita gente enfrenta: instruções longas gastam o espaço de contexto da IA. Quem quer entender melhor esse limite pode ler sobre tokens e janela de contexto. Com skills, o agente mantém dezenas de procedimentos "na gaveta" e abre só o que a conversa pede. A própria especificação recomenda manter o SKILL.md abaixo de 500 linhas e mover o detalhe para arquivos separados.

O que muda com a doação à Agentic AI Foundation

Segundo o anúncio da Anthropic, de 22/10/2026, o padrão passa para a Agentic AI Foundation (AAIF), vinculada à Linux Foundation. A AAIF foi cofundada pela Anthropic com a Block e a OpenAI e já abriga o MCP, o protocolo que conecta agentes a ferramentas. O guia sobre o MCP e como ele conecta agentes de IA explica essa outra peça.

A doação inclui o nome, o logotipo, a organização no GitHub e o domínio agentskills.io. A empresa diz que o formato foi publicado em dezembro de 2025, que mais de 70 plataformas já o adotaram, entre elas ChatGPT, Cursor, GitHub Copilot e VS Code, e cita 1 milhão de skills publicadas e perto de 280 milhões de instalações. Esses números são da própria empresa, não de uma auditoria independente. A notícia resumida está em Anthropic doa o padrão Agent Skills.

Como é um SKILL.md na prática

O arquivo começa com um cabeçalho em YAML e segue com texto em Markdown. Pela especificação, o campo name é obrigatório, tem até 64 caracteres e aceita só letras minúsculas, números e hífens. O campo description também é obrigatório, tem até 1024 caracteres e deve dizer o que a skill faz e quando usá-la. Outros campos, como licença e compatibilidade, são opcionais.

Exemplo para uma marmitaria de bairro

Imagine uma marmitaria que responde pedidos de orçamento para empresas pequenas. O dono escreve uma skill para o agente padronizar a resposta. O texto abaixo é um modelo de estudo, não uma skill testada em produção.

---
name: orcamento-de-marmitas
description: Monta orçamento de marmitas para empresas. Use quando o cliente pedir preço para 10 ou mais refeições por dia.
---

Passos:
1. Pergunte quantidade por dia, dias da semana e endereço.
2. Use a tabela de preços do arquivo references/precos.md.
3. Mostre o total semanal e o prazo de entrega.
4. Termine com a forma de pagamento e peça confirmação.

Nunca prometa desconto que não está na tabela.

Repare em dois detalhes: a descrição diz quando usar, e a regra final limita o que o agente pode prometer. Para quem quer escrever instruções claras em geral, o guia de como escrever comandos que funcionam ajuda.

Skills em outras ferramentas e como encaixam no seu dia

O conceito já aparece fora do universo da Anthropic. O Google, por exemplo, trocou os Gems do Gemini por skills, como mostra o texto sobre Gems que viram skills, e o menu Personalizar do Gemini reúne skills, apps e controle para administradores. Nem toda skill de cada produto segue o mesmo formato aberto, então confira a documentação de cada ferramenta antes de assumir que um arquivo funciona em qualquer lugar.

Para pequenos negócios, o uso mais direto é padronizar o que se repete: respostas a clientes, fechamento de caixa, roteiro de post, conferência de pedido. Um serviço de montar esses pacotes é o assunto de skills do Gemini como serviço.

Riscos e limites que ninguém deve ignorar

Uma skill é, no fim, texto e às vezes código que um agente segue. Isso traz risco. Uma skill baixada de terceiros pode conter instruções escondidas, scripts que acessam arquivos ou comandos que o agente executa sem você perceber. O anúncio da Anthropic menciona, entre as propostas de roteiro, orientações de segurança para quem escreve e para quem instala skills, o que indica que o tema é reconhecido, mas ainda sem prazo.

• Leia o SKILL.md e qualquer script antes de instalar uma skill de fonte desconhecida.
• Dê ao agente só as permissões de que a tarefa precisa, como explica o texto sobre permissões de agentes de IA.
• Não coloque senhas, chaves ou dados de clientes dentro da skill.
• Fique atento ao risco de prompt injection quando a skill manda o agente ler páginas ou e-mails.
• Revise o resultado: skill boa não elimina erro de IA.

Para avaliar qualquer ferramenta nova com calma, o checklist para escolher ferramenta de IA com segurança serve de base.

Por que isso pesa no futuro do trabalho

Skills transformam conhecimento de empresa em ativo portátil. Quem sabe descrever bem um processo passa a ter um diferencial, porque o agente executa o que está escrito, nem mais nem menos. É um traço do que os textos sobre agentes de IA e o futuro do trabalho autônomo e sobre como humanos e agentes vão trabalhar juntos já apontavam: o valor migra de executar para especificar e conferir.

Há também a camada de comunicação entre agentes, tratada no guia do protocolo A2A. Skills, MCP e A2A resolvem problemas diferentes: o que o agente sabe fazer, a que ele se conecta e com quem ele conversa.

Erros comuns de quem começa

• Descrição vaga. Se a descrição diz só "ajuda com orçamentos", o agente não sabe quando acionar. Diga o que faz e quando usar.
• SKILL.md gigante. Textos longos desperdiçam contexto; separe o detalhe em arquivos de referência.
• Instalar sem ler. Trate skill de terceiros como programa baixado da internet.
• Achar que é igual em todo lugar. Compatibilidade varia entre produtos.
• Esquecer de atualizar. Preço e regra mudam; revise a skill de tempos em tempos.

Próximo passo

Escolha uma tarefa que você explica toda semana, escreva os passos em 10 linhas e teste com o agente que você já usa. Se der certo, vale transformar em skill. Acompanhe o tema na categoria de futuro do Portal da AI, que mostra como agentes mudam o trabalho de gente comum.