Aula 13Skills: receitas que o Claude segue

📋 Para esta aula: a pasta da sua página (a confeitaria, ou a da sua ideia), das Aulas 03 a 10. Não precisa do GitHub, de plano especial nem de instalar nada.

Objetivos

Ao final desta aula você vai saber:

• O que é uma skill, a receita que o Claude segue, e por que ter várias não pesa na conversa
• Criar uma skill pedindo ao Claude e aprovar o arquivo na pasta .claude
• Fazer o Claude Code enxergar uma pasta de skills nova, com /reload-skills
• Usar a skill de dois jeitos: pelo pedido, sem citar o nome dela, e pelo nome, com /post-instagram
• Reconhecer, no seu dia a dia, o que merece virar skill
• Onde a skill fica: na pasta do projeto, na sua pasta pessoal ou na sua conta do claude.ai

Na Aula 11, você escreveu as regras da casa no CLAUDE.md: o que vale em toda conversa. Mas tem coisa que só vale numa tarefa e que se repete toda vez que essa tarefa aparece. Um post para o Instagram da confeitaria, por exemplo: frases curtas, tom carinhoso, o preço do doce, o link da página e as hashtags. Explicar tudo isso a cada post cansa, e um dia você esquece um pedaço. Nesta aula, você ensina uma vez, numa skill.

O que é uma skill

Uma skill é uma receita salva num arquivo: o passo a passo de uma tarefa, do seu jeito. Skill quer dizer habilidade, em inglês, e é o nome que o Claude Code usa. A receita fica num arquivo chamado SKILL.md, dentro de uma pasta com o nome da skill: .claude/skills/post-instagram/SKILL.md.

O arquivo é texto simples, em Markdown, como o CLAUDE.md. No topo, entre duas linhas ---, ficam o nome e a descrição, que diz o que a skill faz e quando usar. Embaixo, a receita. A sua vai ficar parecida com esta, e quem escreve é o Claude:

---
name: post-instagram
description: Escreve um post para o Instagram da confeitaria. Use quando eu pedir um post para o Instagram.
---

# Post para o Instagram

- Frases curtas e tom carinhoso.
- O preço do doce, como está no cardápio da página.
- O link da página no fim.
- Cinco hashtags.

Ter várias não pesa. No começo de cada conversa, o Claude lê só o nome e a descrição de cada skill. A receita inteira, ele só abre quando o pedido combina. Por isso, dá para ter várias sem encher a memória de trabalho da conversa (Aula 07).

Dois jeitos de usar

• Sozinho: quando o seu pedido combina com a descrição, o Claude abre a receita e segue, sem você citar a skill. É por isso que a descrição diz quando usar: "use quando eu pedir um post para o Instagram".
• Pelo nome: digite /, o nome da skill e, depois dele, o que você quer: /post-instagram bolo de pote. Toda skill vira um comando com o nome dela.

Criar a skill pedindo

Você não escreve o arquivo: pede, lê o que o Claude propõe e aprova, como fez com as regras da Aula 05. Peça:

crie uma skill do projeto chamada post-instagram, em
.claude/skills/post-instagram/SKILL.md, que escreve um post para o
Instagram da confeitaria: frases curtas, tom carinhoso, o preço do doce,
o link da página no fim e cinco hashtags. A descrição deve dizer para
usar quando eu pedir um post para o Instagram. O preço sai do cardápio
da página; se o doce não estiver lá, me pergunte o preço antes de
escrever. Enquanto a página não estiver no ar, use [link da página] no
lugar do link.

Antes de aprovar, leia a proposta: o nome, a descrição e cada linha da receita. Como a pasta .claude é protegida, no Manual e no Accept edits o Claude pede licença antes de mexer nela (Aula 05). O pedido pode trazer uma opção a mais, que libera a pasta .claude até o fim da conversa. Prefira o Yes simples: assim, você lê cada arquivo antes de ele entrar.

💡 Quer outra receita? Peça a mudança antes de aprovar, como "acrescente que o post termina convidando para encomendar pelo WhatsApp". Depois de aprovado, também dá: peça a mudança no SKILL.md, como em qualquer arquivo.

⚠️ Nada de senha nem dado de cliente na receita. Como o CLAUDE.md, a pasta .claude vai junto quando a página for para o GitHub, num repositório público (Aula 19).

Fazer o Claude Code enxergar a skill

A pasta .claude/skills não existia quando esta conversa começou, então o Claude Code ainda não está de olho nela. Digite:

/reload-skills

Ele procura as skills de novo e responde quantas encontrou e quantas são novas. Para conferir, digite /post: a post-instagram aparece na lista de comandos que abre embaixo. Apague o que digitou e comece uma conversa limpa, para testar sem a conversa da criação no meio:

/clear

💡 Daqui para a frente, vale na hora. O Claude Code acompanha as pastas de skills, e uma mudança na receita vale sem reiniciar. A exceção é só esta: uma pasta de skills criada depois que o Claude Code abriu. Se mudar a receita agora, antes de fechar o Claude Code, rode /reload-skills de novo. Da próxima vez que você abrir, a pasta já existe, e ele acompanha sozinho.

Testar

Na conversa limpa, confira o manual mode on e peça, sem citar a skill:

Escreva um post sobre o bolo de cenoura.

Repare que o Claude carrega a skill antes de escrever: aparece na conversa uma linha com o nome dela. No Manual, ele pede licença antes de usar a skill: aprove. O critério de pronto se vê na resposta: o post sai em frases curtas, com o preço do bolo de cenoura que está no cardápio, o [link da página] no fim e cinco hashtags.

Agora, chame pelo nome:

/post-instagram bolo de pote

O bolo de pote não está no cardápio, e a receita manda perguntar: o Claude tem de pedir o preço antes de escrever, em vez de inventar um. Responda com um preço, como "R$ 12", e confira o post.

Gostou? Peça: "guarde uma versão com a skill post-instagram".

💡 Na Aula 19, troque o link. Quando a página estiver no ar, peça: "na skill post-instagram, troque [link da página] pelo endereço da página no ar".

A regra de ouro

💡 Regra de ouro: se você se pega explicando a mesma coisa para o Claude repetidamente, isso é uma skill esperando para ser escrita.

Na confeitaria, mais duas que valem a pena:

• A resposta para orçamento de festa: os tamanhos de bolo, o prazo mínimo para encomendar e o que perguntar a quem pediu (a data da festa, quantas pessoas, o sabor).
• A mensagem de confirmação de encomenda: o nome de quem encomendou, o doce, a data de entrega e o valor, sempre no mesmo tom.

Cada uma nasce de um pedido como o desta aula, com outro nome e outra receita.

Skill, regra da casa ou comando pronto?

Onde a skill fica

• Do projeto, em .claude/skills/, dentro da pasta da página. É o caso da post-instagram: vai junto com a pasta e, na Aula 19, para o GitHub.
• Pessoal, em ~/.claude/skills/, na sua pasta pessoal (o ~ da Aula 00): vale em todos os seus projetos, neste computador. Para criar uma assim, peça "crie uma skill pessoal chamada…".
• Da sua conta do claude.ai: as skills que você ativa na sua conta também aparecem aqui, quando você entra no Claude Code com essa conta.

Para ir além (opcional): o arquivo por dentro

🔧 Para ir além (para quem já programa; pode pular): esta parte mostra os outros campos do topo do SKILL.md, os comandos antigos, como desligar as skills que pesam e onde cada uma carrega. Se você nunca programou, pule para o Na prática: tudo o que ele pede já foi explicado acima.

Os campos do topo

O bloco entre as linhas --- (o frontmatter, escrito em YAML) aceita mais campos além de name e description. Os mais úteis:

O texto que você digita depois de /nome chega à receita no lugar de $ARGUMENTS. Se a receita não tiver esse marcador, o Claude Code junta o texto no fim, como ARGUMENTS: <o que você digitou>. Foi assim que o bolo de pote chegou à post-instagram.

A pasta da skill pode levar arquivos de apoio, como um referencia.md com detalhes ou um script em scripts/. Cite cada um no SKILL.md, dizendo quando ler: eles só entram no contexto quando o Claude precisa. Mantenha o SKILL.md com menos de 500 linhas.

Comandos personalizados viraram skills

Antigamente, os comandos de barra eram criados em .claude/commands/. Esses arquivos continuam funcionando: um .claude/commands/deploy.md e uma skill .claude/skills/deploy/SKILL.md criam o mesmo /deploy. Para coisa nova, prefira a skill: ela aceita arquivos de apoio e pode ser acionada pelo Claude.

Alguns comandos que vêm com o Claude Code, como o /code-review, o /doctor, o /loop e o /debug, são skills embutidas (bundled skills) e funcionam igual às suas. O ajuste disableBundledSkills desliga todas. E um pacote pronto com várias skills, para instalar de uma vez, é um plugin (Aula 21).

Skill demais também pesa

O nome e a descrição de cada skill ficam no contexto de toda conversa. De vez em quando, rode /skill-doctor (v2.1.252 ou mais nova): ele mostra, na aba Stats do /plugin, quanto contexto cada skill ocupa e quanto ela é usada.

Para desligar uma skill sem apagar o arquivo, use o skillOverrides. O jeito mais fácil é o /skills: escolha a skill, aperte Space para trocar o estado e Esc para salvar no .claude/settings.local.json. Os estados são "on", "name-only" (o Claude vê só o nome), "user-invocable-only" (some para o Claude e fica no menu /) e "off" (some dos dois):

{
  "skillOverrides": {
    "planilha-antiga": "off"
  }
}

As skills de plugins não obedecem ao skillOverrides: desligue o plugin no /plugin. As da conta do claude.ai, você desliga na própria conta; no terminal, o /skills as agrupa como claude.ai sync.

Onde cada skill carrega

Na prática

Use a pasta da sua página (a confeitaria, ou a da sua ideia).

1. Abra o terminal, entre na pasta e abra o Claude Code: cd Documents/confeitaria, com o nome da sua pasta, e depois claude. Aperte Shift + Tab uma vez e confira se aparece manual mode on.
2. Peça a skill, com o pedido de Criar a skill pedindo. Leia a proposta e aprove com Yes.
3. Digite /reload-skills. Depois, digite /post e confira se a post-instagram aparece na lista. Apague o que digitou e digite /clear.
4. Confira o manual mode on e peça: "escreva um post sobre o bolo de cenoura". Aprove o uso da skill e confira as frases curtas, o preço do cardápio, o [link da página] no fim e as cinco hashtags.
5. Digite /post-instagram bolo de pote. Quando o Claude perguntar o preço, responda e confira o post.
6. Peça: "guarde uma versão com a skill post-instagram".
7. Pense numa coisa que você já explicou ao Claude mais de duas vezes e anote: é a sua próxima skill.

Resumo

• Uma skill é uma receita num arquivo SKILL.md, numa pasta com o nome dela. Até ser usada, só o nome e a descrição entram na conversa: ter várias não pesa.
• O Claude segue a receita sozinho quando o pedido combina com a descrição, ou quando você chama pelo nome, como /post-instagram.
• Para criar, peça ao Claude e leia antes de aprovar. A pasta .claude é protegida: no Manual, ele pede licença antes de mexer nela.
• Pasta de skills criada no meio da conversa? Rode /reload-skills. Depois, as mudanças valem na hora.
• O critério de pronto se vê na resposta: o post sai com o preço, o link e cinco hashtags.
• A skill do projeto vai junto com a pasta; a pessoal, em ~/.claude/skills/, vale em todos os seus projetos; e as da sua conta do claude.ai também aparecem.
• Se você vive explicando a mesma coisa, é uma skill esperando para ser escrita.

Na próxima aula, você liga o Claude aos seus apps, como a agenda, com os conectores.

Quer ir mais fundo? Veja a página de skills da documentação oficial (em inglês).