1Você repete as mesmas instruções toda vez

Numa conversa nova, o Claude não lembra do seu jeito de trabalhar. Por isso você cola tudo de novo: o tom, o tamanho, os preços. Quando a lista é longa, sempre falta alguma coisa.

Uma skill resolve isso. Você escreve as instruções uma vez. O Claude passa a segui-las sempre que o pedido for daquele tipo.

A Débora responde uns quinze pedidos de orçamento de banho e tosa por dia. Antes, colava no Claude oito linhas com a tabela de preços e o tom da loja. Com a skill, ela cola só a mensagem do cliente.

2A skill entra sozinha quando o pedido combina

Você não precisa chamar a skill pelo nome. O Claude olha a lista das suas skills e lê uma frase curta de cada uma, a descrição. Se o pedido combina, ele abre aquela skill e segue o que está escrito.

As outras ficam fechadas e não atrapalham. Por isso dá para ter várias skills, uma para cada tarefa.

O Raul tem duas skills: uma para parecer trabalhista e outra para e-mail de andamento ao cliente. Quando ele pede "resuma a audiência de hoje para o cliente", o Claude abre só a do e-mail.

3Vale para o que se repete do mesmo jeito

Escrever uma skill leva uns vinte minutos. Compensa quando a tarefa volta toda semana e você quer o mesmo resultado sempre.

Três casos não pedem skill. A tarefa que acontece uma vez só se resolve na própria conversa. O dado que muda todo dia, como a agenda de hoje, não cabe numa receita fixa. E a regra que vale para qualquer conversa vai nas preferências pessoais, que ficam nas Configurações do app.

A Débora separou as tarefas dela em dois cartões antes de criar a primeira skill.

1O Claude escolhe pela etiqueta

Uma skill tem duas partes que importam aqui: o nome e a descrição. Quando você manda um pedido, o Claude ainda não leu nenhuma skill inteira. Ele tem à mão só essas duas linhas de cada uma.

O nome vem em minúsculas, com hífen no lugar do espaço. Não se preocupe com isso: na aula 5 o Claude escreve o nome por você.

Por isso a descrição é a parte mais importante. Instruções ótimas não servem de nada se a skill nunca for aberta.

A primeira skill do Raul tinha a descrição "Ajuda com documentos jurídicos". Ele pediu um parecer e o Claude não abriu a skill: a frase não falava em parecer.

2Diga o que faz e quando usar

Uma boa descrição tem duas metades. A primeira diz o que a skill faz, começando por um verbo: "Monta", "Responde", "Escreve". A segunda diz quando usar, com as situações em que ela deve entrar.

Escreva como quem apresenta a skill para outra pessoa. Evite "eu sou" ou "você deve": a descrição fala da skill, não com o Claude.

O Raul reescreveu a frase vaga. Veja os dois cartões.

3Use as palavras que você usa ao pedir

O Claude compara o seu pedido com a descrição. Se você escreve "aviso de pet pronto" e a descrição fala em "notificação de conclusão de serviço", a ligação fica fraca. Copie para a descrição as palavras que saem da sua boca.

A Débora testou duas descrições para a mesma skill. O pedido foi igual nas duas vezes.

1Primeiro, ligue a criação de arquivos

Uma skill só funciona se o Claude puder abrir e criar arquivos dentro da conversa. Essa permissão tem um nome comprido: execução de código e criação de arquivos. Ela só deixa o Claude criar arquivos dentro da própria conversa: nada sai do seu computador.

Nos planos individuais, inclusive o gratuito, você mesmo liga. Em conta de empresa, quem administra a conta libera para todos.

A Débora abriu o Claude no computador da loja e achou a chave desligada. Bastou um clique.

2A lista fica em Personalizar › Skills

Com a chave ligada, o app mostra a lista de skills. Lá aparecem as skills prontas da Anthropic, a empresa que faz o Claude, e depois as suas. Cada uma tem uma chave própria de ligar e desligar. Atenção: são dois lugares diferentes. A chave geral fica em Configurações; a lista, em Personalizar.

As prontas cuidam de arquivos de escritório: Word, Excel, PowerPoint e PDF. Você não precisa chamar nenhuma pelo nome.

O Raul conferiu a lista antes de criar qualquer coisa. As quatro estavam ligadas, e ele viu onde a skill dele vai aparecer.

3Peça e veja a skill trabalhar

Agora faça um pedido que pede um arquivo. O Claude percebe que a tarefa combina com a skill de Word, lê as instruções dela e monta o documento.

Para ter certeza, abra o raciocínio do Claude. Ele fica logo acima da resposta, recolhido numa linha. Toque nele e procure o nome da skill. As prontas aparecem com o nome do tipo de arquivo, em inglês: a de Word é "docx".

O Raul pediu a lista de documentos que o cliente traz na primeira consulta. Recebeu um arquivo Word pronto para imprimir.

1Uma pasta com um arquivo de texto

Toda skill é uma pasta. Dentro dela mora um arquivo de texto comum chamado SKILL.md. O ".md" no fim é só o tipo do arquivo, como o ".docx" do Word. Só ele é obrigatório.

O nome da pasta é o nome da skill, em minúsculas e com hífen no lugar do espaço. Se a tarefa precisa de um modelo ou de uma tabela grande, esses arquivos entram na mesma pasta.

A skill de parecer do Raul é uma pasta com dois arquivos: o SKILL.md e o modelo de parecer que o escritório usa há anos.

2Cabeçalho em cima, instruções embaixo

O SKILL.md começa com um cabeçalho, entre duas linhas de três traços. Ali ficam o nome e a descrição que você treinou na aula 2. Não fez a aula 2? A descrição é a frase que diz o que a skill faz e quando usar.

Abaixo do cabeçalho vêm as instruções, escritas como para uma pessoa nova na equipe. No fim, um exemplo de resposta boa.

Esta é a skill de orçamento da Débora, inteira. Leia de cima para baixo.

---
name: orcamento-banho-tosa
description: Responde pedidos de orçamento de banho e tosa com a tabela e o tom da loja. Use quando um cliente perguntar preço de banho, tosa ou pacote.
---

# Orçamento de banho e tosa

## Como responder
1. Cumprimente pelo nome, se a mensagem trouxer.
2. Dê o preço pela tabela. Se faltar o porte, pergunte antes: o preço muda com o tamanho.
3. Ofereça agendar e termine com uma pergunta.
4. Escreva curto: o cliente lê no celular.

## Tabela
Porte pequeno: banho R$ 60, banho e tosa R$ 80
Porte médio: banho R$ 70, banho e tosa R$ 95
Porte grande: banho R$ 90, banho e tosa R$ 130

## Exemplo
Cliente: "Quanto fica a tosa do meu shih-tzu?"
Resposta: "Oi! Shih-tzu é porte pequeno: banho e tosa fica R$ 80. Quer agendar? Me diga o melhor dia."

3Explique o porquê em vez de gritar ordens

O Claude leva ao pé da letra o que está escrito na skill. Ordens em maiúsculas, com "nunca" e "sempre", fazem ele exagerar na regra. Uma frase com o motivo funciona melhor: ele entende quando a regra se aplica.

O Raul tinha escrito a regra das súmulas do jeito antigo. Veja o que mudou quando ele explicou o porquê.

1Comece pelo pedido certo

A Anthropic deixa pronta uma skill que ensina o Claude a criar skills: a skill-creator. Você pede para usá-la, conta a tarefa e entrega o que já tem.

Antes de escrever, ela pergunta. É uma entrevista curta sobre o seu jeito de fazer a tarefa.

O Raul abriu uma conversa nova e colou o pedido abaixo. Recebeu três perguntas antes de qualquer texto.

2Responda com casos reais

A qualidade da skill depende das suas respostas. "O normal" vira uma instrução vaga, e o Claude preenche o resto com o jeito mais comum. Um caso real vira uma regra que ele consegue seguir.

A Débora criou a skill de orçamento. O Claude perguntou: "e quando o cliente não diz o porte do pet?". Veja as duas respostas possíveis.

3Revise o texto e peça o ZIP

Quando termina, o Claude mostra os arquivos da skill ao lado da conversa. Leia o SKILL.md e confira três coisas. O nome no topo é igual ao da pasta. A sua descrição está no cabeçalho. E há um exemplo no fim.

Quer mudar um trecho? Peça na conversa, como faria com uma pessoa. Depois, peça a pasta inteira num arquivo ZIP.

O Raul pediu uma troca de palavra e, em seguida, o arquivo para baixar.

1Quatro passos até a lista

A sua skill entra pelo mesmo lugar onde você viu as prontas na aula 3. Não fez a aula 3? Antes de tudo, clique no seu nome no rodapé do menu lateral, entre em Configurações › Capacidades e ligue a chave "Execução de código e criação de arquivos".

Tenha em mãos o arquivo ZIP da aula 5. Se ele ainda está na pasta de arquivos baixados, arraste para Documentos. Pulou a aula 5? Use o ZIP de exemplo da Débora para treinar o envio.

A Débora fez o envio no computador da loja, entre um banho e outro. Levou menos de dois minutos.

2Confira se ela entrou

Deu certo quando a skill aparece na lista com o nome e a descrição dela, e a chave ligada. Só você a vê. Em conta de empresa, outras pessoas só a recebem se você compartilhar.

O erro mais comum no envio é o arquivo errado: um ZIP sem o SKILL.md dentro, ou o próprio SKILL.md solto.

O Raul errou na primeira vez. Veja os dois cartões.

3Faça um pedido comum e confira

Agora não chame a skill pelo nome. Faça o pedido como faria num dia de trabalho. Se a descrição está boa, o Claude reconhece a tarefa e abre a skill sozinho.

Depois, abra o raciocínio: ele fica recolhido numa linha logo acima da resposta. Toque nele e procure o nome da skill.

Há uma segunda prova, sem abrir nada: a resposta usa algo que só a skill tem, como o preço da sua tabela. Se o bloco não aparecer, pergunte na conversa: "você usou alguma skill nesta resposta? Qual?".

A Débora colou a mensagem de um cliente novo, sem dizer mais nada.

1Peça do jeito que você pede de verdade

Na pressa, ninguém escreve o pedido igual duas vezes. A sua skill precisa abrir nos dois jeitos. Teste uma frase completa e uma abreviada, como sai no celular.

Como saber se abriu? Toque no raciocínio, logo acima da resposta, e procure o nome da skill. Ou veja se a resposta usa algo que só a skill tem, como o preço da tabela. Se o bloco não aparecer, pergunte: "você usou alguma skill nesta resposta? Qual?".

Se um dos jeitos falha, o problema quase sempre está na descrição: faltam as palavras daquele jeito de pedir.

A Débora testou duas mensagens reais de clientes. A segunda veio do jeito que muita gente escreve no WhatsApp.

2Um pedido parecido que não é dela

O teste ao contrário também importa. Faça um pedido do mesmo mundo, mas de outra tarefa. A skill deve ficar fechada.

Se ela abrir sem dever, a descrição está larga demais e vai atrapalhar pedidos que não são dela.

O Raul pediu um e-mail curto ao cliente. A skill de parecer não deveria entrar. Veja o que aconteceu, e como ficou depois da correção que a aula 8 ensina.

3Compare com a skill desligada

Falta saber se a skill melhora o resultado. Desligue a chave dela em Personalizar › Skills, abra uma conversa nova e repita um dos pedidos. Depois, ligue de novo.

A Débora repetiu o pedido do poodle médio com a skill desligada.

1Cada falha tem o seu lugar de correção

As anotações da aula 7 dizem onde mexer. Se a skill não abriu, ou abriu onde não devia, o problema está na descrição. Se abriu e a resposta saiu errada, o problema está nas instruções ou no exemplo.

Mude uma coisa por vez e teste de novo. Assim você sabe o que resolveu.

Na aula 7, o pedido "qto fica pra dar um trato no bichinho?" não abriu a skill da Débora. Ela mexeu só na descrição.

2Peça a correção e troque a versão

Você não precisa reescrever a skill. Volte à conversa em que ela nasceu, na aula 5: ela está na lista de conversas recentes do menu lateral. Não achou? Abra uma conversa nova e anexe o ZIP da skill, que está em Documentos, pelo botão de clipe. Conte a falha e peça só a mudança necessária, com o ZIP novo no fim.

Para trocar a versão, guarde primeiro o ZIP novo em Documentos; o antigo continua lá. Só então abra a skill em Personalizar › Skills, clique nos três pontinhos (…), escolha Excluir e envie o ZIP novo pelo caminho da aula 6.

O teste do Raul mostrou que a skill de parecer abria num e-mail simples. Ele voltou à conversa da aula 5.

3O que não vira skill

Depois da primeira, dá vontade de transformar tudo em skill. Três coisas têm lugar melhor no app. A regra de toda conversa vai nas preferências pessoais. O assunto de um cliente, com documentos e histórico, vai num projeto. O dado que muda o tempo todo vem por um conector.

E uma skill por tarefa. Várias pequenas funcionam melhor que uma enorme que tenta fazer tudo.

O Raul organizou o que tinha no escritório nos dois cartões abaixo.