InícioSkills › Como criar sua primeira Skill em uma hora
Skills e agentes

Como criar sua primeira Skill em uma hora

Por Fábio Hallgren · Atualizado em 17 set 2026 · 4 min de leitura · 894 palavras

Passo a passo para transformar uma tarefa repetida em uma Skill funcional.

Escolha uma tarefa que você já sabe fazer bem.

Guia completo e atualizado

A primeira Skill que escrevi foi para o relatório de terça e sexta, e levou 40 minutos entre escrever, testar e corrigir. O primeiro teste errou o formato da tabela. O segundo saiu certo. Na sexta seguinte, o relatório saiu igual sem eu explicar nada, e foi aí que entendi que tinha criado algo que ia durar. Este é o passo a passo que eu sigo desde então, ajustado depois de umas dez Skills.

Você vai sair daqui com uma Skill funcionando, testada em três casos reais, e com o critério para saber se ela está pronta ou precisa de mais uma rodada.

Escolha a tarefa certa

A primeira Skill deve ser de uma tarefa que você já faz bem, repete com frequência e consegue verificar. Relatório semanal, classificação de leads, resposta padrão a um tipo de e-mail, checklist de publicação. Não comece por algo que você ainda não domina: a Skill escreve o seu processo, e se o processo não existe, ela vai escrever uma bagunça.

Um teste rápido: você consegue explicar a tarefa a um estagiário em cinco minutos, com começo, meio e fim? Se sim, é uma boa primeira Skill.

Leia também · Skills

Anatomia de um SKILL.md

O que vai em cada parte do arquivo de uma Skill e por que a ordem importa. →

Escreva os passos como para um estagiário

Abra um arquivo de texto e escreva o que a pessoa faria: o que abrir, o que olhar, em que ordem, o que calcular, o que entregar. Use frases curtas e verbos no imperativo. "Abra a exportação. Some as conversões por campanha. Compare com a meta da planilha. Liste os três maiores desvios."

Depois, acrescente o formato de entrega (tabela com quais colunas, parágrafo de quantas linhas) e uma lista curta do que não fazer. A lista de proibições é o que mais evita resposta genérica.

Dê um exemplo bom e um ruim

Cole um resultado real que ficou bom, mesmo que resumido, e diga por que ficou bom. Cole um que ficou ruim e diga o motivo. Esse par ensina mais que qualquer instrução. Sem exemplo, a IA entende o passo e entrega em formato diferente do que você imaginava.

A descrição é o gatilho

No cabeçalho, escreva em uma frase o que a Skill faz e quando usar, incluindo as palavras que você realmente diz ao pedir a tarefa. "Use ao pedir relatório de terça, update de KPIs, previsto x realizado." Se a descrição não bate com o pedido, a Skill não dispara.

Teste em três casos reais

Não teste com exemplo inventado. Pegue três pedidos de verdade, de semanas diferentes, e rode a Skill em cada um. Compare com o resultado que você mesmo teria produzido. Se acertou os três, está pronta para uso. Se errou, o erro mostra qual bloco está fraco: formato errado, falta exemplo; passo pulado, falta instrução; disparou na hora errada, descrição vaga.

Corrija só o que errou e rode de novo. Resista a reescrever tudo: Skills melhoram por acúmulo de correções pequenas.

Onde salvar e como nomear

Uma pasta por Skill, com o nome da tarefa em verbo e objeto: analisar-campanhas, escrever-relatorio-semanal, classificar-leads. Dentro, o arquivo principal e, se precisar, arquivos de referência (padrão de nomenclatura, tabela de metas, exemplos longos). Guarde em um repositório ou pasta compartilhada com histórico; a Skill de hoje vai ser diferente da de três meses, e é bom poder voltar.

Um exemplo completo em dez linhas

Descrição: relatório semanal de mídia; use ao pedir relatório de terça, update de KPIs, previsto x realizado. Passos: abra a exportação da semana; some gasto, receita e conversões por campanha; compare com a meta da planilha; liste os três maiores desvios com o número e a causa provável. Formato: tabela com campanha, gasto, receita, ROAS, desvio; depois cinco linhas para o dono da empresa. Evite: recomendar teste sem dado; repetir o que a tabela já mostra; adjetivos. Exemplo bom: o relatório de 10 de setembro. Exemplo ruim: o de 3 de setembro, que só descrevia sem apontar causa.

É pouco, e é o suficiente para a versão um. O resto vem das correções.

O que esperar nas primeiras semanas

A versão um tem dez linhas. A versão de um mês depois tem trinta, e cada linha nova é uma correção que você fez. É assim que deve ser. O sinal de que a Skill amadureceu é quando você deixa de corrigir e passa só a revisar. O sinal de que ela está inchada é quando o arquivo principal não cabe em uma leitura rápida: mova o detalhe para referências.

FHFábio Hallgren

Na minha rotina

Minha primeira Skill, a do relatório, hoje tem quarenta linhas e três arquivos de referência. Cada linha entrou porque a IA errou alguma coisa uma vez. Não errou mais. O tempo de fechar o relatório caiu de uma tarde para uma hora, e a hora que sobra é para decidir o que fazer com os desvios, que é a única parte que ninguém consegue automatizar. Depois dela, criei mais dez, todas seguindo o mesmo ciclo: escrever, testar em três casos, corrigir o que errou.

Perguntas frequentes

Quanto tempo leva de verdade?

Entre 30 e 60 minutos para a primeira versão testada. A maturidade vem em algumas semanas de uso.

Preciso saber programar?

Não. Uma Skill é texto. Se a tarefa exigir script, a IA escreve e você revisa.

Posso usar a Skill em outra ferramenta?

O texto serve como instruções salvas em qualquer assistente; o formato de arquivo muda.

E se a IA ignorar a Skill?

Quase sempre é a descrição. Reescreva com as palavras exatas que você usa ao pedir.

Fontes e método

  • Documentação de Skills da Anthropic
  • Ciclo próprio de criação de dez Skills entre 2025 e 2026