Skills de IA
Ir para notas que citam estaSkills de IA são procedimentos empacotados que o agente carrega quando a tarefa pede, reunindo instruções, formato de saída e material de apoio fora do contexto até o momento do uso.
Elas resolvem um problema recorrente: explicar de novo, a cada conversa, como uma tarefa deve ser feita. Em vez de repetir o roteiro no prompt, o procedimento fica escrito uma vez e o agente o aplica sempre que reconhece a situação. No Harness Engineering, skills fazem parte da frente de ferramentas, ao lado das ferramentas nativas de ler, escrever e buscar arquivos de uma ferramenta como o Claude Code.
Anatomia de uma skill
Uma skill é um arquivo markdown, mas segue um formato próprio, diferente dos demais arquivos de contexto do projeto; formatá-la como markdown comum gera erro. Ela descreve quando deve ser usada, o passo a passo a seguir e o que deve produzir no fim. Não é obrigatório invocá-la por um comando com barra: o agente interpreta em linguagem natural que aquele pedido é o contexto que dispara a skill.
Skills podem ficar no diretório do projeto ou no diretório global do usuário, valendo para qualquer projeto na máquina. As globais tendem a ser mais genéricas; quanto mais específica para a stack real do projeto, mais eficiente ela é. A diferença para os Subagentes está no escopo: a skill ensina como fazer uma tarefa pontual, enquanto um agente especializado define um perfil completo de especialista, com responsabilidades próprias.
Exemplo: a skill de reimaginação de sistema legado
No método Reimagine Your Legend, uma skill recebe o contexto de um sistema legado e devolve, em três estágios, o material das etapas seguintes:
- um resumo da lenda: o que ela representa, o módulo escolhido, o usuário principal, o problema central, as dores, a essência a preservar e as oportunidades de uso de IA;
- a nova jornada sugerida para o usuário;
- um prompt pronto para gerar o protótipo no Google Stitch e um backlog de specs, com a descrição de cada uma, para a implementação com agentes.
A qualidade da saída é proporcional à qualidade da entrada. A skill já conhece o procedimento, mas não conhece o sistema: é preciso fornecer capturas de tela do legado e um texto sobre cores, plataforma web ou mobile e estilo visual. Quando a plataforma fica de fora, o prompt gerado pode sair para mobile mesmo quando a decisão era web.
Skills em projetos de código
Num projeto preparado para agentes, as skills carregam o conhecimento específico da stack: seguir os padrões de código do projeto, usar o Docker, trabalhar com o ORM. Ao gerar uma migration, o agente consulta a skill do ORM e obtém o contexto certo sobre como ele trata migrations. O mesmo pedido num projeto sem skills configuradas segue sem esse contexto.
O roteiro de uma skill é, na prática, um prompt que descreve o resultado esperado. Numa IA sem suporte a skills, colar esse texto junto com o contexto da tarefa produz resultados parecidos, apenas sem o disparo automático.