Kit M4 · Referência: Skills, subagentes, hooks e comandos

🧩 As quatro extensões, lado a lado

Extensão	O que é	Onde vive	Como se usa
Skill	Receita gravada — instruções tuas reutilizáveis	`.claude/skills/<nome>/SKILL.md`	Escreves `/nome` (ou o Claude auto-invoca pela descrição)
Subagente	"Colega especialista" que trabalha à parte	`.claude/agents/<nome>.md`	O Claude delega sozinho, ou pedes "usa o subagente X"
Hook	Regra automática: "quando X, faz Y"	`.claude/settings.json`	Configura uma vez, corre sozinho nos eventos
Conector MCP	Ligação a uma ferramenta externa (Módulo 5)	`claude mcp add …`	O Claude ganha capacidades novas na conversa

Portabilidade: tudo o que está em .claude/ dentro do projecto viaja no git — a equipa inteira herda. O que está em ~/.claude/ (pasta pessoal) é só teu e vale em todos os projectos.

📝 Anatomia de uma Skill

Parte	Para que serve
Pasta `.claude/skills/resumo-dia/`	O nome da pasta é o nome do comando → `/resumo-dia`
Ficheiro `SKILL.md`	As instruções, em texto normal, no teu tom
Descrição (no topo do ficheiro)	Diz ao Claude quando pode invocar a Skill sozinho

Atalho de criação: não escrevas nada à mão — pede ao Claude "cria uma Skill chamada X que faça Y" e revê o resultado.

💡 Ideias de Skills para começar

/resumo-dia — o que foi feito hoje nesta pasta, em 5 linhas

/rever — revisão de texto às minhas regras (PT-PT, tom, gralhas)

/post — transformar uma ideia num post com a minha estrutura

/arruma — arrumar a pasta Downloads pelas minhas categorias

/relatorio — o relatório semanal, sempre com as mesmas secções

O teste: já pediste isto 3 vezes por palavras tuas? É uma Skill. Grava uma vez, usa para sempre.

🗣️ Glossário do módulo

SKILL.md: O ficheiro de instruções de uma Skill. Texto normal, em português.
Frontmatter: O pequeno cabeçalho no topo do ficheiro (entre ---) com a descrição e opções.
Delegar: Quando o Claude principal passa uma tarefa a um subagente especialista.
Evento: O momento que dispara um hook: início de sessão, ficheiro alterado, antes de um comando…