Skills de agente: como o jeito de trabalhar da sua agência vira um pacote que a IA carrega sozinha
Você já viu essa cena: o agente de IA responde bem, escreve bem, entende o briefing. Aí você pede o carrossel do cliente e ele erra o passo que o time nunca erra, esquece a regra de fechamento, usa um formato que a marca não usa. O agente sabe conversar, mas trabalhar do jeito da casa ele ainda não sabe. Skills de agente existem pra fechar essa distância: são o procedimento da agência empacotado num formato que o agente encontra e carrega sozinho, na hora certa.
Neste post a gente explica o que são skills de agente, por que o formato virou padrão de mercado em menos de um ano, o que a pesquisa mostra sobre o ganho real (e sobre o risco de copiar skill da internet), como isso aparece na operação de marketing e o método que a gente usa na Hipercode pra escrever uma skill que funciona. A tese é simples: o valor está no procedimento que a sua agência já tem e nunca escreveu.
O problema que o prompt não resolve
Antes de chegar nas skills de agente, a primeira tentativa de todo mundo é aumentar o prompt. Cola a brand bible, cola o passo a passo, cola três exemplos. Funciona por uma semana. Depois o prompt vira um documento de 4 mil palavras que ninguém mantém, o agente lê tudo em toda tarefa (mesmo quando a tarefa pede 5% daquilo) e ainda esquece o passo 4 porque ele estava enterrado no meio.
Em engenharia de contexto a gente mostrou o motivo: a janela de contexto do agente é um recurso finito, e tudo que entra nela compete por atenção. Quanto mais você cola, menos cada instrução pesa. O prompt gigante resolve o sintoma e piora a causa.
Três camadas que a gente costuma confundir
Quando um agente falha numa tarefa de marketing, o erro quase sempre está numa destas três camadas, e só a última é território das skills de agente:
Conversa
O que você pede hoje, nesta tarefa. É o prompt. Muda a cada pedido.
Acesso
Onde o agente consegue mexer: a conta de anúncios, o CMS, a planilha, o Figma. É a camada de conexão, e a gente tratou dela em MCP no marketing.
Procedimento
Como a casa faz aquele trabalho. A ordem dos passos, o que confere antes de entregar, o que nunca pode sair. É aqui que o prompt quebra e é aqui que a skill entra.
O que são skills de agente
A definição oficial da especificação aberta em agentskills.io cabe numa linha: um formato leve e aberto pra estender a capacidade de um agente de IA com conhecimento e fluxos de trabalho especializados. Na prática, skills de agente são pastas. Dentro de cada uma vive um arquivo chamado SKILL.md com um cabeçalho (nome e descrição) e as instruções do procedimento. Ao lado, opcionalmente, scripts executáveis, documentos de referência e modelos.
A Anthropic, que criou o formato, descreve skills como pastas organizadas de instruções, scripts e recursos que os agentes conseguem descobrir e carregar dinamicamente pra executar melhor tarefas específicas, no texto de outubro de 2025 que apresentou o padrão. A palavra importante ali é “descobrir”. Em vez de receber a skill colada no prompt, o agente sabe que ela existe e vai buscar quando a tarefa pede. O nome oficial do padrão é Agent Skills.
A pasta por dentro
SKILL.md
Obrigatório. Cabeçalho com name e description, depois as instruções em texto: o passo a passo, as regras, os exemplos de entrada e saída. A documentação oficial recomenda manter o corpo abaixo de 500 linhas e quebrar em arquivos separados quando passar disso.
scripts/
Código que o agente executa sem precisar ler. Um validador de formato, um script que puxa dados de uma API, um conversor. O agente roda o script e só a saída entra no contexto.
references/
Documentação que o agente consulta quando precisa: o guia de voz da marca, a tabela de especificações de anúncio, o glossário do cliente.
assets/
Modelos e recursos prontos: o template do relatório, a estrutura do carrossel, a planilha base.
Carregamento progressivo em três estágios
O que faz o formato funcionar é o jeito que o agente carrega a skill. A especificação chama de progressive disclosure e divide em três momentos:
Descoberta
Ao iniciar, o agente carrega só o nome e a descrição de cada skill disponível. É o suficiente pra saber quando ela pode ser relevante. Dezenas de skills de agente instaladas custam só o cabeçalho de cada uma, e nada mais.
Ativação
Quando a tarefa bate com a descrição, o agente lê o SKILL.md inteiro pro contexto. Só agora as instruções completas entram.
Execução
O agente segue as instruções e, se precisar, roda os scripts ou abre os arquivos de referência. Um por vez, sob demanda.
Esse mecanismo resolve o problema do prompt gigante: o conhecimento da agência pode crescer sem limite prático, porque só o pedaço necessário pra tarefa de agora entra na janela. A Anthropic afirma, no mesmo texto, que o contexto que dá pra empacotar numa skill é, na prática, ilimitado.
Por que virou padrão de mercado em menos de um ano
A linha do tempo das skills de agente é curta. Em outubro de 2025 a Anthropic lançou skills de agente no Claude. Em dezembro do mesmo ano publicou a especificação como padrão aberto e abriu um diretório de skills construídas por parceiros, entre eles Canva, Notion, Figma, Atlassian, Zapier e Cloudflare. Em 19 de agosto de 2026 a Skills API saiu do beta na API do Claude.
O dado que mais importa pra quem contrata software, porém, está no showcase oficial de agentskills.io. Em 13 de setembro de 2026, o site lista 46 produtos compatíveis com o formato. Entre eles: Claude e Claude Code, ChatGPT e Codex (OpenAI), Gemini CLI (Google), GitHub Copilot, Cursor, Goose (Block) e Kiro (Amazon). Os três maiores laboratórios de modelo leem o mesmo formato de skill.
Duas frases dos parceiros resumem a mudança. A Canva disse que, com skills, o Claude passa a entender como trabalhar dentro do Canva, além de só se conectar a ele. A Zapier disse que skills codificam procedimentos repetíveis e boas práticas, enquanto as ferramentas MCP executam esses procedimentos em escala.
Pra uma agência, a consequência prática é a mesma que a gente apontou sobre o MCP: uma skill escrita hoje pro seu agente roda amanhã em outro agente, de outro fornecedor, sem reescrever. O procedimento da casa deixa de estar preso à ferramenta do momento.
O que a pesquisa mostra sobre skills de agente
A pergunta honesta sobre skills de agente é: quanto o agente melhora de verdade com uma skill? O SkillsBench, benchmark publicado em fevereiro de 2026 e revisado em junho, com 77 autores, mediu isso do jeito certo: 87 tarefas em 8 domínios, cada uma rodada com e sem skill curada, em 18 combinações de modelo e ambiente, com verificação determinística do resultado.
Dado
Skill curada sobe a taxa de acerto do agente em 16,6 pontos
Taxa média de acerto nas 87 tarefas do SkillsBench, 18 configurações de modelo e ambiente, 2026
Fonte: SkillsBench: Benchmarking How Well Agent Skills Work Across Diverse Tasks, arXiv 2602.12670, v4, junho de 2026. Ganho por configuração variou de +4,1 a +25,7 pontos.
Dezesseis pontos de acerto é muito. Pra ter noção: na operação de conteúdo, é a diferença entre uma peça em cada três sair aprovada de primeira e uma em cada duas. Mas os dois achados secundários do estudo importam ainda mais pra quem vai escrever skills de agente na agência.
Skill focada ganha de pacote enorme
O estudo concluiu que skills focadas, com no máximo três módulos, superam pacotes maiores ou exaustivos. Isso contraria o instinto de colar tudo que a agência sabe numa skill só. A skill boa faz uma coisa: monta o carrossel, gera o relatório, audita o post. Quem tenta cobrir a operação inteira num pacote reproduz o problema do prompt gigante dentro da pasta.
Modelo menor com skill empata com modelo maior sem
O segundo achado tem efeito direto na conta. Modelos menores com skills conseguiram igualar modelos maiores sem skills. Se você leu sobre custo de IA no marketing, sabe o que isso significa: o procedimento bem escrito permite rodar a tarefa num modelo mais barato com o mesmo resultado. A skill vira alavanca de custo, além de alavanca de qualidade.
Um cuidado: o benchmark mediu skills curadas, escritas com critério e testadas. Skill mal escrita não entra nessa média. Por isso a gente insiste em avaliar o agente antes e depois de instalar qualquer procedimento novo.
O lado que ninguém posta: skill copiada da internet é risco
Onde tem padrão aberto de skills de agente, tem diretório público. E onde tem diretório público, aparece skill de qualidade duvidosa. Em fevereiro de 2026 a Snyk, empresa de segurança que times de desenvolvimento usam pra auditar dependências de código, publicou o ToxicSkills, o primeiro scan amplo de segurança do ecossistema de skills de agente: 3.984 skills públicas de dois dos maiores repositórios abertos, analisadas em 5 de fevereiro.
Fonte: Snyk, ToxicSkills, scan de 3.984 skills do ClawHub e do skills.sh em 5 de fevereiro de 2026.
O padrão de ataque tem nome: injeção de instrução dentro da skill (o texto manda o agente vazar dados ou executar comando), segredo exposto no código (10,9% das skills de um dos repositórios) e script que baixa conteúdo perigoso de terceiros. A própria Anthropic, criadora do Claude e do formato, avisa no texto de lançamento que skills maliciosas podem introduzir vulnerabilidades no ambiente ou direcionar o agente a exfiltrar dados, e recomenda instalar só de fonte confiável e auditar antes. Um levantamento acadêmico de junho de 2026 chegou a número parecido: 26,1% das skills contribuídas pela comunidade têm vulnerabilidade.
Isso muda a pergunta certa sobre skills de agente. Em vez de “onde baixo uma skill de carrossel”, a agência deveria perguntar “como escrevo a nossa”. Uma skill roda código com as permissões do agente, e o agente tem acesso às contas do cliente. Já mostramos em segurança de agentes de IA o que acontece quando esse acesso cai em instrução errada. Quatro regras que a gente segue pra skills de agente:
Fonte conhecida
Skill de fornecedor oficial (Canva, Notion, Figma) ou escrita em casa. Diretório aberto só depois de ler cada arquivo.
Script lido antes de rodar
Todo script dentro da pasta é lido por uma pessoa antes da primeira execução. Se baixa algo da internet, é reprovado.
Permissão mínima
A skill que gera relatório lê a conta de anúncios. Ela não precisa de permissão pra editar campanha.
Versão controlada
Skill vive em repositório com histórico. Mudou, alguém revisou. Igual código.
Skills de agente na operação de marketing: três exemplos
Na Hipercode a regra é uma só: todo procedimento que o time repete mais de duas vezes vira uma das skills de agente da casa. É assim que a gente monta as equipes operacionais de IA que rodam a operação dos clientes. Três exemplos do que está dentro dessas pastas:
Carrossel de um cliente específico
O SKILL.md descreve o formato (quantidade de cards, hierarquia de texto, onde entra o CTA), aponta pro guia de voz em references/ e pro template em assets/. Um script em scripts/ confere o que a marca proíbe: travessão, frase acima de N caracteres no card de capa, palavra da lista negra. O agente monta, roda o validador, corrige e só então entrega. É o mesmo processo que a gente descreveu em marketing de conteúdo com IA, só que empacotado de um jeito que o agente aciona sozinho quando alguém pede “carrossel pro cliente X”.
Relatório semanal de mídia
Aqui o peso está no script. Ele puxa os dados da conta de anúncios pela API, calcula as métricas do jeito que o cliente entende e devolve uma tabela limpa. O SKILL.md ensina o agente a ler essa tabela: o que é sinal de alerta, o que é ruído de fim de semana, como escrever a nota de recomendação. Sem a skill, o agente reinventa a consulta toda semana e erra a comparação de período.
Auditoria SEO de um post antes de publicar
Um checklist de onze itens (keyword no título, nos primeiros parágrafos e num H2, densidade, links internos e externos, alt em toda imagem) e um script que mede densidade e conta links. O agente escreve, audita, corrige o que falhou e repete até passar. A regra de aprovação humana fica no fim, num ponto só.
Repare no padrão das skills de agente. Nos três casos, o conhecimento que virou skill já existia: estava na cabeça do designer, na planilha do gestor de tráfego, no checklist do redator. A gente escreveu sobre isso em treinamento de IA no marketing: o time aprende sozinho e o conhecimento fica preso em cada pessoa. A skill é o lugar onde ele vira ativo da empresa.
Como a gente escreve skills de agente: o método em seis passos
A documentação oficial da Anthropic tem uma frase que virou regra na casa: crie avaliações antes de escrever documentação extensa. A skill nasce de uma falha observada, não de uma lista de tudo que a gente gostaria que o agente soubesse. O método:
Passo 1: rodar a tarefa sem skill e anotar onde erra
Pede o carrossel do jeito normal, três vezes. Anota cada erro. Esses erros são o conteúdo da skill. O que o agente já acerta sozinho fica de fora.
Passo 2: escrever três casos de teste antes da instrução
Três pedidos reais com o resultado esperado. Sem isso você escreve a skill imaginando o problema em vez de resolvendo o que aconteceu.
Passo 3: descrição em terceira pessoa com o gatilho
A descrição é o que o agente lê pra decidir se ativa a skill entre dezenas de outras. Ela diz o que a skill faz e quando usar: “Monta carrossel pro cliente X no formato aprovado. Usar quando pedirem carrossel, post em cards ou conteúdo pra feed do cliente X”. Se a descrição for vaga, a skill nunca dispara.
Passo 4: escolher o grau de liberdade
A documentação usa uma imagem boa: ponte estreita com abismo dos dois lados pede instrução exata; campo aberto sem perigo pede direção geral. Publicar no CMS do cliente é ponte estreita, vai como script com comando fixo. Escolher o ângulo do texto é campo aberto, vai como orientação.
Passo 5: script pro que é frágil, texto pro que é julgamento
Tudo que é determinístico (validar, converter, calcular, publicar) vira script. Roda mais confiável que código gerado na hora, gasta menos token e sai igual toda vez. Tudo que exige critério fica em texto, com exemplos.
Passo 6: rodar em tarefa real, observar, voltar
A skill entra em produção com um agente e uma pessoa olhando. Onde o agente tropeçou, a skill ganha uma linha. Onde ele nunca abriu um arquivo de referência, o arquivo sai. A skill fica mais curta com o tempo, e isso é sinal de que está madura.
Uma regra de forma a mais pra skills de agente: arquivos de referência ficam a um nível só de distância do SKILL.md, porque o agente pode ler só o começo de um arquivo referenciado dentro de outro e perder o que estava no fundo.
Skill, MCP, contexto e prompt: o que vai em cada lugar
Se você acompanha o nosso pilar sobre arquitetura de agentes pra marketing, já tem o mapa da orquestração. Skills de agente entram como a quarta peça do desenho de cada um:
Prompt
A tarefa de hoje. “Faz o carrossel da campanha de setembro do cliente X.” Muda a cada pedido.
Contexto
O que o agente precisa saber agora: o briefing da campanha, a foto aprovada, o dado da semana. Entra sob demanda, do jeito que a gente descreveu em engenharia de contexto.
MCP
Onde o agente mexe: o Figma, o CMS, a conta de anúncios. É a conexão, com permissão por ferramenta.
Skill
Como a casa faz aquele trabalho. O procedimento, o validador, o modelo. Fica igual entre pedidos e muda quando o processo muda.
Quando um agente erra, essa separação diz onde consertar. Se o dado saiu errado, o conserto está no contexto. Já quando o agente acerta o conteúdo mas trava na hora de publicar, o problema é de conexão, e quando ele publica no formato que a marca nunca usou, é a skill de agente que precisa de uma linha a mais. Antes dessa divisão, tudo era “melhorar o prompt”, e o prompt ficava cada vez maior e cada vez pior.
Perguntas frequentes sobre skills de agente
O que são skills de agente?
São pastas com um arquivo SKILL.md (nome, descrição e o procedimento em texto) e, opcionalmente, scripts, documentos de referência e modelos, que o agente de IA descobre e carrega sozinho quando a tarefa pede. É o formato aberto Agent Skills, criado pela Anthropic em outubro de 2025 e publicado como especificação em dezembro. Skills de agente empacotam o jeito de trabalhar da casa: a ordem dos passos, o que confere antes de entregar, o que nunca pode sair.
Qual é a diferença entre skills de agente e um prompt bem escrito?
O prompt muda a cada pedido e compete por atenção na janela de contexto: quanto mais você cola, menos cada instrução pesa. Skills de agente entram por carregamento progressivo: ao iniciar, o agente lê só nome e descrição de cada uma; quando a tarefa bate, lê o SKILL.md inteiro; e só então roda scripts ou abre referências, sob demanda. O conhecimento da agência pode crescer sem limite prático, porque só o pedaço necessário pra tarefa de agora entra na janela.
Skills de agente funcionam em qualquer ferramenta de IA?
Cada vez mais. O showcase oficial de agentskills.io listava, em 13 de setembro de 2026, 46 produtos compatíveis, entre eles Claude e Claude Code, ChatGPT e Codex, Gemini CLI, GitHub Copilot, Cursor, Goose e Kiro. Os três maiores laboratórios de modelo leem o mesmo formato. Pra uma agência, isso significa que a skill escrita hoje roda amanhã em outro agente, de outro fornecedor, sem reescrever o procedimento. É isso que torna skills de agente um investimento portátil.
Quanto as skills de agente melhoram o resultado?
O SkillsBench, com 87 tarefas em 8 domínios e 18 combinações de modelo e ambiente, mediu 16 pontos de acerto a mais com skill curada. Dois achados secundários pesam mais pra quem vai escrever: skills focadas, com no máximo três módulos, superam pacotes exaustivos; e modelos menores com skills igualam modelos maiores sem. Skills de agente bem escritas viram alavanca de custo além de qualidade. Skill mal escrita não entra nessa média.
É seguro baixar skills de agente de diretório público?
Só com auditoria. O scan ToxicSkills da Snyk analisou 3.984 skills públicas e achou injeção de instrução dentro da skill, segredo exposto no código (10,9% em um dos repositórios) e script que baixa conteúdo perigoso de terceiros; um levantamento acadêmico chegou a 26,1% de skills da comunidade com vulnerabilidade. Skills de agente rodam com as permissões do agente, que tem acesso às contas do cliente. Fonte conhecida, script lido antes de rodar, permissão mínima e versão controlada.
Como escrever skills de agente que funcionam?
Partindo de uma falha observada, não de uma lista de tudo que o agente deveria saber. Rode a tarefa sem skill três vezes e anote onde erra; escreva três casos de teste antes da instrução; faça a descrição dizer o que a skill faz e quando usar; escolha o grau de liberdade (ponte estreita pede script com comando fixo, campo aberto pede orientação); deixe o determinístico em script e o julgamento em texto; e rode em tarefa real com uma pessoa olhando. Skills de agente maduras ficam mais curtas com o tempo.
Que procedimentos da agência viram skills de agente primeiro?
Os que o time repete mais de duas vezes e nos quais o agente erra o passo que o time nunca erra. Na Hipercode, os três primeiros costumam ser o carrossel de um cliente específico (formato, voz, template e um validador do que a marca proíbe), o relatório semanal de mídia (script puxa e calcula, o SKILL.md ensina a ler) e a auditoria SEO do post antes de publicar (checklist e script de densidade e links). O conhecimento já existia na cabeça de alguém; a skill é onde ele vira ativo da empresa.
Por onde começar esta semana
Pega os três procedimentos que o time mais repete e mais reclama. Em geral são um relatório, um formato de peça e uma checagem antes de publicar. Roda cada um sem skill, anota os erros, escreve os três casos de teste e monta a primeira pasta. Skills de agente curtas, uma por procedimento, com script no que é frágil. Em duas semanas você tem o começo de uma biblioteca de skills de agente que roda em qualquer agente que o mercado lançar.
Se quiser ver como a gente estrutura essa biblioteca pra uma operação de marketing inteira, com os procedimentos, os validadores e o gate humano no lugar certo, fala com a gente. O diagnóstico começa pelo mapa do que o seu time já sabe fazer e nunca escreveu.