Este é o capítulo 3 de Operação IA, série em cinco partes sobre como transformar ferramentas de IA em ambiente de trabalho para profissionais de Digital. No capítulo 1, você delegou sua primeira tarefa a um agente. No capítulo 2, escreveu o arquivo de contexto que ensina o agente quem você é. Se está chegando agora, volte dois capítulos: aqui a gente constrói em cima.
Faça um exercício rápido de memória. Pensa nas tarefas que você pediu para uma IA nos últimos trinta dias. Quantas eram inéditas, e quantas eram a mesma tarefa de sempre com dados novos? Auditoria de títulos, briefing de pauta, análise de campanha, relatório de mês. Aposto na segunda coluna, porque o trabalho de Digital é feito de processos que se repetem, e é exatamente por isso que ele é automatizável.
Só que tem um detalhe incômodo no seu fluxo atual: toda vez que você repete a tarefa, você repete a explicação. O processo mora na sua cabeça e sai pelo prompt, de novo, a cada vez, com pequenas variações que geram pequenas inconsistências. O arquivo de contexto do capítulo 2 resolveu o “quem somos”. Ele não resolve o “como fazemos”. Este capítulo resolve.
O que é uma skill
Uma skill é um processo empacotado. Tecnicamente, uma pasta com um arquivo dentro, chamado SKILL.md, onde você descreve passo a passo como uma tarefa deve ser executada: o que fazer primeiro, quais critérios aplicar, qual formato entregar. Salvou a pasta no lugar certo, o agente passa a ter aquela capacidade. Para sempre, em toda sessão, sem você explicar de novo.
Se o arquivo de contexto é o onboarding do analista, a skill é o POP, o procedimento operacional padrão. Toda operação madura tem os seus, escritos ou não. A diferença é que os seus, a partir de hoje, executam.
E aqui vem a parte elegante do desenho, porque a skill funciona de dois jeitos ao mesmo tempo. Você pode invocá-la manualmente, digitando uma barra e o nome dela na sessão, tipo /auditoria-titulos, como um comando. Ou pode simplesmente pedir a tarefa em português normal (“roda a auditoria de títulos deste export”) e o agente reconhece sozinho que existe uma skill para aquilo e a carrega. Ele decide com base na descrição que você escreveu no topo do arquivo. Uma skill bem descrita se ativa sozinha na hora certa.
Tem engenharia bonita por trás disso, e vale uma frase para você confiar no mecanismo: o agente não carrega todas as suas skills o tempo todo. Ele lê apenas o nome e a descrição de cada uma no início da sessão, e só puxa o conteúdo completo quando a tarefa pede. Você pode acumular dezenas de skills na prateleira sem pesar nada. O nome disso é progressive disclosure, e é o que torna a prateleira escalável.
Tutorial: suas duas primeiras skills
Chega de conceito, vamos empacotar dois processos reais. No Claude Code, skills de projeto vivem em .claude/skills/nome-da-skill/SKILL.md dentro da sua pasta de trabalho. Se quiser que a skill valha para todos os seus projetos, o endereço é ~/.claude/skills/ na sua pasta de usuário. Depois de criar ou editar uma skill, reinicie a sessão para ela carregar.
O arquivo tem duas partes: um cabeçalho em YAML com name e description, e o corpo em Markdown com o processo. O cabeçalho merece atenção desproporcional ao tamanho, porque a descrição é o gatilho: é ela que o agente compara com o seu pedido para decidir se ativa a skill.
Skill 1: a auditoria do capítulo 1, agora permanente
Crie .claude/skills/auditoria-titulos/SKILL.md:
---
name: auditoria-titulos
description: Audita titles e meta descriptions a partir de um export
CSV do Search Console. Usar quando o pedido envolver auditoria de
títulos, CTR baixo ou reescrita de metas.
---
# Auditoria de títulos
## Processo
1. Localize o CSV do Search Console na pasta. Se houver mais de um,
pergunte qual usar. Se não houver nenhum, pare e avise.
2. Calcule a mediana de CTR do conjunto.
3. Filtre as 30 páginas com mais impressões e CTR abaixo da mediana.
4. Acesse cada URL e extraia o title atual.
5. Diagnostique cada title em uma frase: o problema principal, não
uma lista de problemas.
6. Sugira um title novo seguindo as regras técnicas do CLAUDE.md.
## Critérios de diagnóstico
- Title que descreve o site em vez do conteúdo da página
- Promessa que o conteúdo não cumpre
- Corte por excesso de caracteres na SERP
- Ausência de motivo para o clique
## Entrega
CSV em /saidas com as colunas: URL, impressões, CTR, title atual,
diagnóstico, sugestão. Ao final, resuma os 3 padrões de problema
mais frequentes encontrados.
Pronto. A tarefa que no capítulo 1 exigiu um prompt de dez linhas agora se resolve com “roda a auditoria de títulos”. E repare no ganho que importa mais que a economia de digitação: o processo ficou consistente. Mês que vem, a auditoria vai seguir os mesmos passos e os mesmos critérios, porque eles não dependem mais do seu prompt do dia.
Skill 2: briefing de pauta no padrão da casa
Crie .claude/skills/briefing-pauta/SKILL.md:
---
name: briefing-pauta
description: Gera briefing de pauta editorial completo a partir de
um tema ou palavra-chave. Usar quando o pedido for criar briefing,
pauta ou estrutura de artigo novo.
---
# Briefing de pauta
## Processo
1. Receba o tema. Se a intenção de busca não estiver clara, pergunte
antes de seguir.
2. Pesquise o que já rankeia para o tema e identifique o ângulo que
os resultados atuais não cobrem.
3. Verifique no sitemap ou na lista de URLs da pasta se já existe
conteúdo nosso sobre o tema. Se existir, proponha atualização em
vez de artigo novo e justifique.
4. Monte o briefing no template abaixo.
## Template de entrega
- Tema e intenção de busca (uma linha cada)
- Ângulo diferencial: o que este artigo diz que os rankeados não dizem
- Estrutura sugerida de H2s, com uma frase por seção sobre o que cobrir
- Perguntas que o texto precisa responder
- Links internos candidatos (das URLs existentes na pasta)
- O que NÃO incluir neste artigo, e onde esse recorte mora (pauta irmã)
## Regras
- Máximo uma página. Briefing longo não é briefing, é rascunho.
- Toda sugestão de H2 precisa servir à intenção de busca declarada.
- Aplicar tom, audiência e regras técnicas do CLAUDE.md.
Duas observações de construção antes de você adaptar. Primeira: as duas skills mandam o agente parar e perguntar em situações específicas (arquivo ausente, intenção ambígua). Isso é o hábito do capítulo 2 descendo para dentro do processo. Segunda: as duas referenciam o CLAUDE.md em vez de repetir as regras. Contexto diz quem você é uma vez; skills apontam para ele. Regra duplicada é regra que diverge.
As três regras da boa skill
Depois que a primeira funciona, a tentação é empacotar tudo. Três regras evitam os erros clássicos.
Uma skill, um processo. O erro mais comum documentado por quem constrói skills profissionalmente é a mega-skill, aquela que tenta cuidar de pauta, revisão, publicação e relatório ao mesmo tempo. Ela dispara em hora errada e executa tudo pela metade. Se o seu SKILL.md tem mais de um “Processo”, são duas skills.
A descrição é o produto. Se a skill não dispara quando deveria, ou dispara quando não deveria, o problema está quase sempre na descrição do cabeçalho. Escreva nela quando usar, com as palavras que você usaria no pedido.
Comece pelo processo que você mais repete e que mais dói padronizar no time. O retorno composto vem de skills que rodam toda semana, não da skill genial que roda duas vezes por ano.
E uma nota de coerência com o capítulo 2, porque você vai descobrir que existe uma skill oficial da Anthropic chamada skill-creator, que entrevista você e monta o arquivo. Pode usar, ela é boa de estrutura. A ressalva é a mesma do arquivo de contexto: o esqueleto pode vir da ferramenta, o processo e os critérios têm que vir de você. Skill com processo genérico é prompt genérico com endereço fixo.
Plugins: quando a prateleira vira distribuição
Uma camada acima das skills existem os plugins: pacotes que reúnem skills, comandos e configurações num repositório distribuível. Instala com um comando, e a Anthropic mantém um marketplace oficial, com muitos outros mantidos pela comunidade.
Para o profissional de Digital, o plugin interessa por dois motivos em ordens diferentes de importância. O menor: instalar pacotes prontos dos outros. O maior: distribuir os seus. Se você lidera um time, o conjunto de skills da sua operação empacotado num plugin significa que todo analista novo instala o playbook inteiro no primeiro dia. O conhecimento que hoje mora em documentos que ninguém abre passa a morar em ferramentas que executam. Volto a esse tema no capítulo 5, quando falarmos de operação em escala.
Um fato recente torna isso ainda melhor: desde março de 2026, o mesmo formato de skill funciona também no Claude.ai e nos apps, fora do terminal. A skill que você escreveu hoje para o agente serve amanhã no chat do celular. O ativo acompanha você pelo ecossistema inteiro.
E no Codex e no Antigravity?
Melhor notícia da série até aqui: o padrão de skills se tornou aberto, no mesmo movimento do AGENTS.md do capítulo 2. O Codex e o ChatGPT Desktop suportam o mesmo formato Agent Skills, e o mesmo SKILL.md roda lá com ajustes mínimos de cabeçalho. Suas duas skills de hoje já são portáteis.
No Antigravity, o quadro em meados de 2026 é de transição: a plataforma tem seu próprio sistema de comandos customizados e workflows, que cobre o mesmo caso de uso, e o suporte ao padrão aberto de skills vinha sendo implantado no ecossistema Google ao longo do ano. Se o Antigravity é a sua casa, verifique a documentação atual antes de estruturar a prateleira, e escreva os processos em Markdown puro de qualquer forma: o conteúdo migra fácil, seja qual for o formato do contêiner.
O padrão se repete, e a esta altura da série você já reconhece o desenho: contexto portátil, skills portáteis. O que você constrói viaja com você. A dependência fica cada vez mais fina.
O que você construiu e o que falta
Faz a conta do que existe na sua pasta depois de três capítulos: um agente instalado, um arquivo de contexto que carrega sua operação, duas skills que executam seus processos com consistência de máquina e critério de gente. Isso já é mais infraestrutura proprietária de IA do que a maioria das empresas que você conhece tem hoje.
Mas tem um teto nessa arquitetura, e você vai bater nele em uma semana de uso: tudo o que o agente sabe do mundo entra por arquivo que você exporta e arrasta para a pasta. Export do Search Console, export do Analytics, export do CRM. Você virou o office boy dos seus próprios dados.
No capítulo 4, o agente para de trabalhar sobre exports e passa a se conectar direto às suas ferramentas: Search Console, Analytics, planilhas, CMS, automações. O nome do cabo é MCP, e junto com ele vem a conversa mais séria da série sobre permissões e riscos. Semana que vem, aqui.