Pular para o conteúdo
LabS Atlas
Agentic AI
Entrar

Skills de IA

Ir para notas que citam esta
atualizado há 25 diasEntre para perguntar ao Labinho sobre esta notaO Labinho é o assistente que responde com as notas e as sessões do LabS e mostra de onde tirou cada resposta.

Skills 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:

  1. 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;
  2. a nova jornada sugerida para o usuário;
  3. 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 texto da skill também serve como prompt

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.