Curso + Pacote Comercial · R$ 397 · Conhecer o curso

Ceridório

Biblioteca / Começar

Passo a passo · Começar · novembro de 2026

Monte uma skill parte por parte: o que vai em cada pedaço do arquivo, sem programar

Nome, descrição, passos, modelo da entrega, regras e arquivo de apoio: cada parte de uma skill explicada, com um exemplo inteiro para adaptar.

Veio do Reel? A palavra era CRIAR.

Você já percebeu que explica a mesma tarefa à IA toda semana. O formato, as regras, o «não esquece de…». A saída é transformar essa explicação numa skill: um procedimento escrito que o Claude lê quando a tarefa aparece. Este guia mostra cada parte do arquivo, o que escrever nela e por quê. No fim, você tem uma skill inteira de exemplo para adaptar à sua tarefa.

Veio do Reel? A palavra era CRIAR.

O que você vai montar

Uma pasta com um arquivo principal, o SKILL.md, e, se precisar, um arquivo de apoio. O SKILL.md tem seis partes:

  1. Nome: curto, sem espaço.
  2. Descrição: quando usar. É ela que faz o Claude achar a skill.
  3. Passos: o que fazer, na ordem.
  4. Modelo da entrega: o formato exato do resultado.
  5. Nunca faça: o que é proibido, sem exceção.
  6. Arquivo de apoio (opcional): a tabela, a lista ou o texto de referência que a skill consulta.

Se você quer o caminho mais rápido, em que a IA entrevista você e escreve a primeira versão, veja Três jeitos de criar uma skill. Aqui o foco é entender cada parte, para você conseguir ajustar qualquer skill depois.

Passo 1: escolha uma tarefa que mereça

Boa tarefa para skill tem três traços: se repete, tem formato conhecido e é barata de errar no começo.

Na Distribuidora Modelo (empresa fictícia que usamos nos exemplos: distribuidora de produtos de limpeza para mercados, padarias e restaurantes da Grande São Paulo e de Campinas), o Rafael, da Logística, escolheu o aviso de rota. Toda semana ele escreve aos clientes de uma rota avisando o dia e a janela de entrega. O texto é sempre parecido, e as regras são sempre as mesmas.

Passo 2: nome e descrição

O arquivo começa com um cabeçalho de duas linhas entre traços:

---
name: aviso-de-rota
description: Use quando pedirem o aviso de rota, a mensagem para os clientes de uma rota de entrega, ou "avisa os clientes de quinta". Gera um rascunho por cliente a partir da lista da rota. Não envia nada.
---

O nome é a identidade da skill. Letras minúsculas e hífen.

A descrição é a parte mais importante do arquivo inteiro. O Claude lê a descrição de todas as skills instaladas e escolhe a que serve para o pedido. Por isso:

  • Diga quando usar, com as palavras que alguém usaria ao pedir.
  • Diga o que entrega, em uma frase.
  • Diga o limite, se houver: «não envia nada».

Descrição vaga, como «ajuda com logística», faz a skill nunca ser encontrada, ou ser encontrada na hora errada.

Passo 3: os passos, na ordem

Depois do cabeçalho, escreva o procedimento como você explicaria a um colega no primeiro dia:

## Passos
1. Peça a lista da rota se ela não veio no pedido: cliente, dia, janela
   de horário. Não comece sem a lista.
2. Confira se cada cliente tem dia e janela. Se faltar, marque FALTA
   e não escreva a mensagem desse cliente.
3. Escreva uma mensagem por cliente, seguindo o modelo abaixo.
4. No fim, liste o que o Rafael precisa conferir antes de enviar.

Passos numerados, um verbo por passo. Se um passo tem «e depois», provavelmente são dois.

Passo 4: o modelo da entrega

Mostre o formato exato. Não descreva, mostre:

## Modelo da entrega
Para cada cliente:

CLIENTE: [nome]
Oi! Aqui é o Rafael, da Distribuidora Modelo.
A entrega de vocês sai na [dia], entre [janela].
Se precisar mudar, responda esta mensagem até [dia anterior], 16h.

Depois de todos:
CONFERIR ANTES DE ENVIAR
- [o que faltou ou parece estranho]

Um exemplo preenchido vale mais que três parágrafos de explicação. Se você tem uma mensagem real boa, sem dado pessoal, cole como exemplo logo abaixo.

Passo 5: o «nunca faça»

Esta seção é curta e dura. Nada de «cuidado com» ou «evite». Regra clara:

## Nunca faça
- Não envie mensagem a ninguém. Entregue o rascunho e pare.
- Não prometa horário fora da janela que está na lista.
- Não invente dia ou janela. Se faltar, escreva FALTA.
- Não inclua telefone, endereço ou nome do contato do cliente.

Toda skill que gera algo que sai da empresa termina num rascunho e para. Quem envia é uma pessoa. Na Distribuidora, é o próprio Rafael.

Passo 6: o arquivo de apoio, se precisar

Algumas skills precisam consultar algo que muda: uma tabela de preços, a lista de rotas, as regras de frete. Em vez de escrever isso dentro do SKILL.md, ponha num arquivo separado na mesma pasta e cite no passo:

aviso-de-rota/
  SKILL.md
  rotas.md      ← dias e janelas de cada rota

E no passo 1: «Se o pedido não trouxer a janela, consulte rotas.md.» Quando a rota de quinta para Campinas passou a sair às 6h, o Rafael mudou uma linha no rotas.md, e a skill não precisou ser reescrita.

Passo 7: instale e teste

O caminho depende de onde você usa o Claude:

  • No app: compacte a pasta e envie na área de skills das configurações, se o seu plano oferecer. Confira na documentação do seu plano.
  • No Claude Code: salve a pasta dentro da pasta de skills do seu usuário, ou na do projeto, para o time usar junto.

Depois, abra uma conversa nova e peça do jeito natural, sem falar em skill: «faz o aviso para os clientes de quinta». Olhe três coisas:

  1. A skill foi usada? Se não, a descrição precisa das palavras que você usou no pedido.
  2. Veio no formato? Se não, ponha um exemplo preenchido no modelo.
  3. Respeitou o «nunca faça»? Se escorregou, deixe a regra mais concreta.

Cada correção é uma linha. Em duas ou três rodadas a skill fica do seu jeito.

Passo 8: dê um dono

Skill de empresa precisa de uma pessoa responsável. Ela aprova mudanças e decide quando a skill está velha. A do aviso de rota é do Rafael. Sem dono, aparecem cópias diferentes da mesma skill e ninguém sabe qual vale.

O que a IA não faz aqui

  • Não sabe a regra que você não escreveu. Se está só na sua cabeça, a skill não segue.
  • Não envia. A skill para no rascunho, por regra.
  • Não se atualiza sozinha. Mudou a regra da empresa, alguém muda o arquivo.

O fecho

A primeira skill feita parte por parte leva mais tempo do que pedir à IA para escrever. Em troca, você entende o que cada linha faz e consegue consertar qualquer skill depois. Para ver onde a skill se encaixa ao lado de prompt, agente e rotina, leia Prompt, skill e agente. E, para saber quais vale ter primeiro, veja Skills essenciais.

Sem custo

Leve a skill onde-a-ia-economiza pronta.

A skill faz 8 perguntas sobre a sua semana e devolve as tarefas que mais valem virar skill, o cuidado de cada uma (dado sensível, aprovação antes de sair) e por onde começar. Ela não inventa número nem promete economia.

Dúvidas rápidas

Preciso saber programar para criar uma skill?

Não. A skill é um arquivo de texto com algumas linhas de cabeçalho. Você escreve em português, como escreveria um procedimento para um colega novo.

Qual a diferença entre a skill e as instruções do projeto?

As instruções valem para toda conversa dentro do projeto. A skill é um procedimento para uma tarefa e entra só quando essa tarefa aparece, em qualquer conversa.

Onde eu instalo a skill?

No app, na área de skills das configurações, se o seu plano tiver. No Claude Code, numa pasta de skills do seu usuário ou do projeto. Confira a documentação do seu plano.

A skill pode enviar mensagem ou salvar arquivo sozinha?

Não deve. Toda skill que gera algo para fora da empresa termina num rascunho e para. Quem envia é uma pessoa.