O terceiro chat começa outra vez com a mesma explicação: que detalhes pertencem ao briefing, que termos usa a equipa e o que deve acontecer quando falta alguma coisa? A repetição é um bom sinal de que podes pôr por escrito uma forma de trabalhar. Uma skill transforma-a numa instrução reutilizável que aplicas deliberadamente e que continuas a manter.
Para o Claude Code, a documentação oficial sobre skills descreve um SKILL.md com metadados e instruções. Pode ser usado quando uma tarefa se adequa ou quando é invocado explicitamente. Isto altera a instrução para o trabalho, não os pesos treinados do modelo. Os ficheiros abaixo são um esboço ilustrativo nosso, não um relatório sobre uma execução realizada.
Primeiro a decisão, depois o ficheiro
O nosso exemplo é uma noite de reparações mensal. A partir de notas organizativas deve ser produzido um briefing interno. Nele, os ajudantes precisam dos acordos confirmados, das tarefas e das decisões em aberto. É uma incumbência mais pequena do que planear o evento inteiro.
Redige previamente um contrato de entrada. Cada detalhe precisa de um valor e de um estado. “Início 18:00, confirmado” é diferente de “Início 18:00, sugestão”. A IA deve preservar essa diferença. Se faltar o local, isso é uma questão em aberto; uma morada substituta com ar plausível violaria a incumbência.
Mantém o SKILL.md curto e inequívoco
Uma localização possível ao nível do projeto é .claude/skills/reparaturbrief/. Poderia conter a seguinte instrução de trabalho própria. Os metadados explicam quando é necessária; o texto abaixo descreve o que deve entregar.
---
name: reparaturbrief
description: Creates internal briefings for repair evenings from organisational notes.
---
Record confirmed details and suggestions separately.
Do not invent venues, dates, names or commitments.
If there are contradictions: state both details and phrase a follow-up question.
Output:
1. Confirmed arrangements
2. Tasks with confirmed responsibility
3. Open decisions with a reference to the input
4. Next coordination stepUma descrição como “ajuda em tudo o que tem a ver com organização” diria menos. Torna difícil perceber onde a skill se encaixa e quando é adequada outra forma de trabalhar. Um limite claro também facilita a manutenção posterior.
Uma passagem de testemunho de exemplo com uma lacuna real
Usa notas artificiais: a sala está confirmada, a hora de início ainda é apenas uma sugestão e os materiais só serão encomendados depois de o orçamento ser aprovado. Indica estas condições diretamente. Um resultado esperado pode conter uma tarefa “Esclarecer o orçamento”. Já “Materiais encomendados” seria uma afirmação nova e sem fundamento.
Uma instrução adicional útil diz: “Para cada decisão em aberto, indica que parte da entrada a origina.” Isto cria uma ligação entre a lacuna e a sua origem. A skill não tem de repetir o texto original inteiro; deve tornar fácil encontrar o detalhe em causa.
Mantém uma preferência de estilo separada das regras de conteúdo. Um exemplo de descrições de tarefas curtas pode servir de ficheiro de apoio. Já os detalhes do evento que mudam com frequência pertencem à incumbência individual. Assim, a instrução geral não fica desatualizada com a próxima data.
Três casos revelam fragilidades diferentes
No primeiro caso, forneces detalhes completos e coerentes. No segundo, falta a data e duas notas sobre o orçamento contradizem-se. No terceiro, pedes algo fora do âmbito da skill, como o planeamento de uma viagem. Isto permite-te observar separadamente a estrutura, o tratamento da incerteza e os limites de utilização.
Para cada caso, regista o que tem obrigatoriamente de ser preservado. Avalia uma resposta primeiro por isso e só depois pelo estilo. Uma formulação elegante não compensa uma data inventada. Da mesma forma, uma pergunta de seguimento não é um erro se for exatamente essa decisão que falta na entrada.
Manter uma pequena instrução de trabalho
Quando um problema se repete, altera uma regra específica e repete os casos existentes. Acrescenta um caso novo que ainda não era conhecido quando a alteração foi escrita. Isto torna mais fácil perceber se a regra se limita a reproduzir um único exemplo.
Regista o motivo da alteração e o seu estado. Ao início, isso não exige nenhuma grande infraestrutura. Uma nota curta como “As condições do orçamento têm de ser preservadas na lista de tarefas” é mais fácil de acompanhar do que uma reescrita completa sem motivo. Uma skill compensa quando as suas regras tornam a próxima passagem de testemunho real mais fácil de compreender.
Fontes e estado da documentação: 25 de outubro de 2026.
