we love business · claude basics aula 03

guia prático · primeiros passos com o claude

O esqueleto pra criar sua primeira skill

Uma skill é uma instrução que você escreve uma vez e reusa toda vez que precisar daquela tarefa de novo. Aqui você sai com um esqueleto pronto pra copiar, um exemplo preenchido e o passo a passo pra salvar e testar a sua.

4 partes obrigatórias 1 esqueleto pronto 1 exemplo real A regra dos 3 usos
confidencial Arquivo claude-basics-isca-skill · guia prático

antes · repetir o pedido

Explicar a mesma tarefa do zero, toda vez que precisa

1 skill

depois · a skill pronta

~ $ /orcamento

Um gatilho, e a tarefa sai do jeito certo sozinha

O que vira skill

Nem toda tarefa precisa virar uma

01

A pergunta de teste

Você já pediu isso 3 vezes?

Uma skill só vale a pena quando você percebe que está repetindo o mesmo tipo de pedido, com a mesma estrutura, mais de uma vez. Então faça a pergunta de teste antes de estruturar qualquer coisa.

  1. Conte quantas vezes já pediuVocê já pediu pra IA fazer essa mesma tarefa, ou uma bem parecida, 3 vezes ou mais?
  2. Se sim, é candidata a virar skillA repetição paga o esforço de estruturar. Vale escrever a skill agora.
  3. Se foi só uma vez, ainda não valeÉ mais rápido só pedir direto dessa vez, e guardar a ideia pra quando a repetição aparecer.

o sinal mais claro de todos

Se você começar a digitar um pedido e pensar "ah, isso eu já expliquei outro dia", esse é o sinal mais claro de que já passou da hora de virar skill. Repetição incomoda antes de você contar.

02

Onde muita gente escorrega

Escreva pro padrão, não pro caso

Uma skill se escreve pro padrão que se repete, não pro caso específico daquele dia. Confundir os dois é o que faz uma skill nascer travada, servindo pra uma situação só.

é padrão

Responder e-mail de orçamento. Serve pra qualquer pedido de orçamento que chegar.

é instância única

Responder o e-mail do João sobre o orçamento de terça. Só serve uma vez.

respira

Pense no que se repete por trás dos casos. Se você trocar o nome, a data e o valor e a tarefa continua a mesma, aquilo é o padrão, e é ele que vira skill.

As 4 partes

Faltando uma, a skill fica ambígua

01

O endereço da skill

Nome e palavra-gatilho

O nome curto da skill e a palavra ou frase que você digita pra acioná-la. É o endereço dela: sem isso, você não consegue chamar a skill de novo depois.

exemplo de gatilho

Uma skill chamada responder e-mail de orçamento pode ter o gatilho /orcamento. Curto, fácil de lembrar, difícil de digitar errado.

02

O escopo em uma linha

Objetivo em 1 frase

Uma única frase dizendo o que a skill resolve. É o teste de escopo mais rápido que existe.

se não couber em 1 frase

É sinal de que a skill está tentando fazer coisa demais. Considere quebrar em duas, cada uma com seu próprio objetivo claro.

03

A sequência exata

Passo a passo detalhado

A sequência exata que a IA deve seguir, numerada. Quanto mais específico, menos espaço pra ela inventar do jeito errado.

escreva como pra quem nunca fez

Descreva cada passo como se estivesse explicando pra alguém que nunca fez aquilo antes. O que parece óbvio pra você precisa estar escrito.

04

A parte que mais gente esquece

Restrições: o que ela nunca faz

A parte que mais gente esquece, e a mais importante. São os limites da skill: o que ela jamais deve fazer sozinha, mesmo que pareça uma boa ideia no momento.

sem isso, a IA toma liberdade

Sem essa lista, a IA eventualmente vai tomar uma liberdade que você não queria. Sem a seção de restrições, a skill não está pronta: não pule essa parte achando que "não vai precisar".

O esqueleto

Copie o bloco e preencha cada colchete

05

O modelo real

O esqueleto pra copiar

Esse é o modelo real. Copie o bloco abaixo inteiro e preencha cada colchete com o conteúdo da sua skill.

Esqueleto da skill · copie e preencha
# Nome da skill: [nome curto]
Gatilho: "/[palavra-que-aciona]"

## Objetivo
[o que esta skill faz, em 1 frase]

## Passo a passo
1. [primeiro passo]
2. [segundo passo]
3. [terceiro passo]

## Restrições (o que ela NUNCA pode fazer)
- [restrição 1]
- [restrição 2]

o esqueleto é o mínimo

Pode adicionar mais passos ou mais restrições do que o modelo mostra. O esqueleto é o mínimo, não o teto.

06

O mesmo esqueleto, na prática

Um exemplo preenchido de verdade

Pra tirar a dúvida de como fica na prática, aqui está o mesmo esqueleto preenchido com uma skill real: responder e-mail de orçamento.

Exemplo real · skill preenchida
# Nome da skill: responder e-mail de orçamento
Gatilho: "/orcamento"

## Objetivo
Escrever uma resposta educada e completa pra quem pediu
orçamento por e-mail, incluindo prazo, valor de referência
e próximo passo.

## Passo a passo
1. Ler o e-mail recebido e identificar o que a pessoa
   pediu (produto, serviço, prazo desejado).
2. Confirmar os dados de contato (nome, e-mail, telefone
   se houver).
3. Montar a resposta com: agradecimento breve, resumo do
   que foi entendido, faixa de valor ou próximo passo pra
   fechar valor exato, prazo de resposta.
4. Terminar sempre perguntando se a pessoa quer agendar
   uma conversa.

## Restrições (o que ela NUNCA pode fazer)
- Nunca informar um valor fechado sem confirmação prévia,
  só faixas de referência.
- Nunca prometer prazo de entrega sem checar a agenda antes.
- Nunca enviar o e-mail sozinha, sempre deixar em rascunho
  pra revisão.

Salvar e testar

O único jeito de pegar os furos

07

Onde a skill mora

Onde salvar

Salve o arquivo da skill na pasta de skills do seu usuário: a pasta que a sua ferramenta de IA usa pra carregar skills automaticamente todo início de sessão.

nome que você reconheça

Dê um nome de arquivo que bata com o nome curto da skill, pra você reconhecer depois sem precisar abrir cada uma.

08

Conversa nova, só o gatilho

Como testar

Abra uma conversa nova e digite só a palavra-gatilho. Se a IA reconhecer, seguir o passo a passo na ordem certa e respeitar as restrições sem você precisar lembrar de nada, a skill está funcionando.

Conversa nova · só o gatilho
~ $ /orcamento   # só isso · a skill assume daqui

se ela pular passo

Se a IA pular um passo ou tomar uma liberdade da lista de restrições, volte no texto e deixe mais específico. Teste sempre em um caso real, não hipotético: é a única forma de pegar os furos do passo a passo.

Dúvidas comuns

A regra dos 3 usos e o resto

Qual é a regra dos 3 usos?
Antes de escrever qualquer skill, pergunte: "eu já fiz essa tarefa pelo menos 3 vezes do mesmo jeito?" Se a resposta for sim, vale o tempo de estruturar. Se for não, é mais rápido só pedir direto dessa vez, e guardar a ideia pra quando a repetição aparecer.
Posso ter mais passos ou restrições do que o esqueleto mostra?
Pode, sim. O esqueleto é o mínimo, não o teto. Adicione quantos passos e restrições a sua skill precisar. O que não pode é faltar uma das 4 partes obrigatórias.
Preciso mesmo da seção de restrições?
Precisa. É a parte que mais gente esquece e a mais importante. Sem a lista de restrições, a skill não está pronta: sem ela, a IA eventualmente toma uma liberdade que você não queria.

~ $ /orcamento
✓ Skill reconhecida, seguindo o passo a passo e respeitando as restrições

Agora você tem o esqueleto, um exemplo real e sabe onde salvar e testar.

Da próxima vez que perceber que está repetindo um pedido pela terceira vez, você já sabe exatamente o que fazer com ele. E esse é só o começo: é dentro da comunidade que a gente vai fundo em criar skills de verdade, junto.

Quero entrar na comunidade →