Quando uma tarefa exige as mesmas explicações toda vez, existe uma oportunidade de transformar essas instruções em um procedimento. Uma skill organiza esse método para que ele possa ser encontrado e reutilizado.

Na nossa estrutura, o conhecimento do projeto fica separado dos procedimentos dos assistentes. Isso permite melhorar uma rotina sem reescrever o contexto de todos os projetos.

Escolha uma entrega pequena

Para começar, use uma tarefa com entrada e saída fáceis de reconhecer. Exemplo: transformar um relato de trabalho em uma nota com situação, tentativa, evidência e próximo passo. O critério de qualidade é preservar o que foi informado.

Crie o arquivo da skill

No Claude Code local, uma skill do projeto pode ficar em .claude/skills/registrar-aprendizado/SKILL.md. O arquivo combina campos de identificação com instruções em Markdown. Documentação de skills ↗.

Terminal · dentro de um projeto de teste
mkdir -p .claude/skills/registrar-aprendizado

Crie o arquivo SKILL.md nessa pasta com este exemplo:

SKILL.md · exemplo didático
---
name: registrar-aprendizado
description: Organiza uma experiência em uma nota reutilizável.
---
Leia o relato completo antes de escrever.
Entregue: situação, tentativa, evidência e próximo passo.
Separe fato observado de hipótese.
Se uma informação faltar, marque "não informado".
Não invente resultados nem publique a nota.

Teste a ausência de informação

Abra o Claude Code nesse projeto e peça /registrar-aprendizado junto de um relato fictício. Faça dois testes: um com todos os dados e outro sem resultado informado. No segundo, a resposta deve preservar a lacuna, sem inventar um desfecho.

Se o resultado variar demais, refine o critério de saída. Se a skill ficou longa, confira se ela está tentando resolver mais de uma tarefa.

Compartilhar sem duplicar

Na base IA Configuração, usamos uma fonte canônica para os procedimentos e adaptadores para os assistentes. Esse arranjo exige uma integração própria: criar a pasta no Claude Code não instala automaticamente a skill em outra ferramenta. O método pode ser reutilizado; o carregamento precisa ser conferido em cada ambiente.

Uma próxima evolução é separar exemplos e referências do procedimento principal, mantendo a instrução inicial curta.

Rascunho para revisão de Davi Wallace. Os exemplos são didáticos. Este texto ainda não foi publicado.