Em palavras simples
Até agora, cada vez que queres algo repetido, escreves o pedido outra vez. Este módulo ensina o Claude a decorar as tuas rotinas: gravas as instruções uma vez, e depois é só invocá-las. É a diferença entre explicar a receita ao cozinheiro todos os dias e tê-la afixada na parede da cozinha.
Um ficheiro de texto = um comando novo
Uma Skill é uma pasta com um ficheiro de instruções (SKILL.md) que vive dentro do teu projecto, em .claude/skills/. Cada Skill torna-se um comando /teu-nome que podes invocar quando quiseres:
- Crias
.claude/skills/relatorio/SKILL.md com as instruções → passas a ter o comando /relatorio
- O ficheiro é texto normal em português: descreves o que o Claude deve fazer, passo a passo, no teu tom
- Skills guardadas em
~/.claude/skills/ (na tua pasta pessoal) funcionam em todos os teus projectos
- Se preencheres a descrição da Skill, o Claude pode até invocá-la sozinho quando fizer sentido
Na prática: qualquer pedido que já escreveste três vezes merece ser uma Skill. "Prepara o post do LinkedIn com o meu tom", "faz a revisão de ortografia às minhas regras" — grava uma vez, usa para sempre.
A tua equipa de assistentes especializados
Um subagente é um "Claude especialista" que o teu Claude principal pode chamar para tarefas específicas. Define-se num ficheiro em .claude/agents/:
- Cada subagente tem a sua especialidade (descrita por ti) e trabalha numa "sala à parte", sem atafulhar a tua conversa principal
- O Claude delega sozinho: pede uma tarefa que casa com a especialidade e ele passa o trabalho ao especialista
- Exemplos: um "revisor" que verifica textos às tuas regras; um "investigador" que procura informação em muitos ficheiros e só te traz a conclusão
Skill vs subagente: a Skill é uma receita (instruções que o teu Claude segue); o subagente é um colega (outro Claude que trabalha em paralelo). Começa pelas Skills — os subagentes chegam quando as tarefas crescem.
"Sempre que acontecer X, faz Y"
Um hook é uma regra automática configurada nas definições do Claude Code (o ficheiro settings.json dentro de .claude/): quando acontece um certo evento, corre uma acção tua — sem ninguém pedir.
- "Sempre que a sessão começa" → mostra-me um lembrete
- "Sempre que um ficheiro é alterado" → formata-o automaticamente
- "Antes de correr um comando" → verifica se é seguro (podes bloquear!)
Os hooks são o nível mais avançado deste módulo — fica com a ideia, e quando precisares de um, pede ao próprio Claude: "configura-me um hook que faça X". Ele conhece a sintaxe exacta.
How-to 1 · Primeira Skill
Criar o teu primeiro comando /skill
Vais gravar uma rotina real tua como Skill. Escolhe algo que pedes muitas vezes — o exemplo usa um resumo diário, adapta ao teu caso.
- 1
Na sessão do Claude, pede por palavras tuas: "Cria uma Skill chamada resumo-dia em .claude/skills/ — quando eu escrever /resumo-dia, deves ler o que foi feito hoje nesta pasta (ficheiros alterados, commits) e escrever-me um resumo de 5 linhas em português."
- 2
Aprova a criação do ficheiro .claude/skills/resumo-dia/SKILL.md e espreita o conteúdo — vê como as tuas instruções ficaram gravadas.
- 3
Testa: escreve /resumo-dia. O Claude segue a receita.
- 4
Afina: se o resultado não for exactamente como querias, pede: "edita a Skill para incluir também X". As receitas melhoram com o uso.
How-to 2 · Primeiro subagente
Criar um subagente especialista
Vais criar um "colega revisor" que verifica textos segundo as TUAS regras.
- 1
Pede: "Cria um subagente chamado revisor em .claude/agents/ — a especialidade dele é rever textos em português de Portugal: caça gralhas, sugere frases mais curtas e garante que o tom é próximo e directo."
- 2
Aprova a criação do ficheiro e espreita-o: repara na descrição (é ela que diz ao Claude principal quando deve delegar).
- 3
Testa: "usa o subagente revisor para rever o texto do ficheiro ideias.md".
- 4
Observa a diferença: o especialista trabalhou à parte e trouxe-te só o resultado — a tua conversa principal continua limpa.
How-to 3 · A Skill que vale ouro
Automatiza a TUA rotina mais repetida
Agora a sério: identifica a tarefa que mais repetes na tua semana e transforma-a numa Skill à tua medida.
- 1
Pensa: o que é que pedes (ao Claude, ou fazes à mão) pelo menos uma vez por semana, sempre da mesma forma? Escreve o processo em 3-6 passos, como explicarias a um estagiário.
- 2
Entrega ao Claude: "Cria uma Skill chamada [nome] com este processo: [os teus passos]. Deve perguntar-me primeiro [o que varia de vez para vez]."
- 3
Testa com um caso real desta semana. Afina o que sair torto.
- 4
Faz um commit: "grava as Skills e o subagente no git" — estas receitas são agora parte do teu projecto, versionadas como tudo o resto.
Leva isto contigo
Tabela de referência imprimível: Skills, subagentes, hooks e conectores lado a lado, com ideias para começar.
🖨️ Cheat-sheet M4