Quando usar um agente e quando usar uma skill

A diferença em uma frase

Um agente recebe um objetivo e decide como chegar lá. Uma skill recebe uma tarefa e segue um procedimento já escrito. O agente tem papel, contexto e critério próprios. A skill tem instruções, e às vezes código, que funcionam do mesmo jeito toda vez que são chamadas.

De onde veio a regra

O experimento #007 compilou 14 fontes de pesquisa num squad de context engineering. A arquitetura ficou com 9 agentes, 8 skills e 6 workflows. A descoberta mais relevante foi que dividir assim é mais simples e mais forte do que fazer tudo com agentes. Cada agente carrega os próprios frameworks completos, sem referências externas, e o trabalho mecânico fica nas skills.

Como decidir em cada etapa

1. A etapa exige escolha? Se duas pessoas competentes fariam de jeitos diferentes, é trabalho de agente.
2. A etapa se repete igual? Se o passo a passo cabe numa lista fixa, é skill.
3. Como você vai conferir? Se um teste resolve, é skill. Se precisa de critério e leitura, é agente, com uma verificação separada.
4. Na dúvida, menos agentes. Foi o que funcionou no #007: menos agentes, cada um mais completo, e o repetitivo em skills.

Os erros mais comuns

1. Agente para tudo. Cada passo mecânico vira um agente, e o sistema ganha custo e pontos de passagem onde pode falhar, como descrito em sistemas multi-agente.
2. Skill que decide. O procedimento acumula "se isso, faça aquilo" até virar julgamento. Nesse ponto, é hora de um agente.
3. Agente sem skills. O agente reescreve do zero, toda vez, um procedimento que poderia estar escrito uma vez só.