Aula 13Skills: receitas que o Claude segue

🖥️ Versão Desktop. Nesta versão do curso, você usa o Claude Code no app Claude Desktop, na aba Code. Quase tudo é feito por janelas e botões. Quando uma aula pedir para digitar um comando, ela mostra exatamente o que digitar. Nesta aula, você digita só o nome da skill, /post-instagram, na caixa de mensagem. A parte opcional do fim cita alguns comandos do terminal, como o /skill-doctor, para quem já programa.

📋 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 aceitar o arquivo na pasta .claude
• Abrir uma conversa nova, com + New, para o app enxergar uma pasta de skills nova
• Usar a skill de dois jeitos: pelo pedido, sem citar o nome dela, e pelo nome, com /post-instagram na caixa de mensagem
• 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 / na caixa de mensagem, ou clique no +, ao lado da caixa, e escolha Slash commands (comandos de barra). Escolha a skill na lista: ela aparece destacada na caixa. Escreva depois dela o que você quer, como bolo de pote, e envie. 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 aceita, 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 aceitar, 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). É a sua chance de ler cada arquivo antes de ele entrar. Se estiver certo, aceite.

💡 Quer outra receita? Peça a mudança antes de aceitar, como "acrescente que o post termina convidando para encomendar pelo WhatsApp". Depois de aceito, 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 app enxergar a skill

A pasta .claude/skills não existia quando esta conversa começou, então a conversa aberta ainda não está de olho nela. Comece uma conversa nova: clique em + New e confira, na linha abaixo da caixa de mensagem, a pasta da página e o Manual. A conversa nova serve também para testar a skill sem a conversa da criação no meio.

Para conferir, digite / na caixa de mensagem: a post-instagram aparece na lista que abre. Apague o / antes de seguir. Se nem assim ela aparecer, feche o app e abra de novo.

💡 Daqui para a frente, vale na hora. O Claude Code acompanha as pastas de skills que já existiam quando a conversa começou, e uma mudança na receita vale na mesma conversa. Como a pasta das skills agora existe, toda conversa nova já está de olho nela. Só uma pasta de skills criada no meio de uma conversa pede + New de novo.

Testar

Na conversa nova, 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: aceite. 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: digite / na caixa de mensagem, escolha a post-instagram, escreva depois dela bolo de pote e envie.

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, nas sessões Local deste 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 nas sessões do app. Para ver quais são, clique em Customize, na barra lateral.

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ê escreve depois da skill, na caixa de mensagem, 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ê escreveu>. 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, são skills embutidas (bundled skills) e funcionam igual às suas. Nas sessões Local do app (e também nas SSH e WSL), o resultado do /code-review chega num card Code review, separado por arquivo. O ajuste disableBundledSkills desliga todas as embutidas. 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, abra o menu /, veja quais skills você nunca usa e desligue essas, sem apagar nenhum arquivo. O /skill-doctor, que mede quanto contexto cada skill ocupa e quanto ela é usada, fica na versão do terminal.

Para desligar uma skill sua, peça ao Claude para incluir o nome dela na configuração skillOverrides do seu ~/.claude/settings.json, arquivo que o app lê do mesmo jeito que o terminal:

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

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). As skills de plugins não obedecem ao skillOverrides: desligue o plugin em + → Plugins → Manage plugins. As da sua conta do claude.ai, você liga e desliga em Customize.

Onde cada skill carrega

Na prática

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

1. Na aba Code, clique em + New. Na linha abaixo da caixa de mensagem, escolha Local e a pasta da sua página. Antes da primeira mensagem, escolha Manual no seletor de modo, na mesma linha.
2. Peça a skill, com o pedido de Criar a skill pedindo. Leia a proposta e aceite.
3. Clique em + New e confira, na linha abaixo da caixa de mensagem, a pasta e o Manual. Digite / e confira se a post-instagram aparece na lista. Apague o /.
4. Peça: "escreva um post sobre o bolo de cenoura". Aceite 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 /, escolha a post-instagram, escreva bolo de pote depois dela e envie. 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: / na caixa de mensagem, ou + → Slash commands.
• Para criar, peça ao Claude e leia antes de aceitar. A pasta .claude é protegida: no Manual, ele pede licença antes de mexer nela.
• Pasta de skills criada no meio da conversa? Abra uma conversa nova, com + New. 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, nas sessões Local; e as da sua conta do claude.ai aparecem em Customize.
• 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) e a parte sobre skills no guia do app Desktop (em português).