O que são skills de agentes?

Skills de agentes são pacotes portáteis de conhecimento procedural que ensinam um agente de IA a executar uma tarefa específica e repetível. Uma skill pode incluir instruções, scripts executáveis, referências, templates e outros recursos carregados quando a tarefa exige.

Segundo a especificação aberta Agent Skills, uma skill é um diretório com um arquivo SKILL.md obrigatório. Esse arquivo contém metadata YAML com nome e descrição, seguida por instruções em Markdown. Scripts, referências e assets opcionais ficam no mesmo pacote.

Uma skill não é uma tool. Uma tool oferece ao agente uma ação como search-customer ou create-task. A skill explica quando e como usar tools, qual sequência seguir, quais padrões aplicar, qual output produzir e como tratar casos limite.

Prompts copiados entre chats são difíceis de manter, testar e distribuir. Skills transformam um processo repetível em um pacote nomeado que pode ser versionado, revisado, compartilhado e melhorado sem adicionar todas as instruções a cada sessão.

Skills também reduzem a pressão sobre a janela de contexto por progressive disclosure. O agente vê metadata compacta das skills disponíveis, carrega o SKILL.md completo somente quando uma skill corresponde à tarefa e abre scripts ou referências apenas quando as instruções exigem.

Para uma empresa, isso cria uma forma prática de capturar conhecimento operacional. Uma boa skill pode preservar um método de relatório, padrão documental, checklist de análise ou workflow de clientes, enquanto permissões e aprovações continuam sob controle do runtime.

No início da sessão, o agente recebe um catálogo com nome e descrição de cada skill. A descrição determina a ativação, então precisa explicar o que a skill faz e quando deve ser usada.

Quando uma solicitação corresponde, o agente carrega SKILL.md. Ele segue as instruções, lê arquivos de referência quando necessário e pode executar scripts incluídos se o runtime permitir code execution. Os recursos são resolvidos a partir do diretório da skill, mantendo o pacote portátil.

A skill não concede novas permissões sozinha. Acesso a arquivos, execução de código, requests de rede ou tool calls por MCP ainda dependem do sandbox, configuração de tools, credenciais e políticas de aprovação do agente host.

Uma equipe de receita cria uma skill de account brief. A descrição informa que ela deve ser usada antes de renovações e reuniões executivas. SKILL.md define seções, hierarquia de fontes, verificações de atualização e a regra de que cada risco precisa ter evidência.

A skill inclui um script para normalizar datas e uma referência com as etapas de oportunidade. Quando alguém pede um brief, o agente carrega as instruções, consulta as tools aprovadas do CRM, executa o script e abre a referência somente ao classificar a oportunidade.

Se a conta não tiver uma data de renovação atual, a skill não inventa uma. Ela marca o campo como ausente, vincula os registros consultados e pede confirmação antes de compartilhar o brief final.

Mantenha cada skill focada em um resultado repetível. Escreva uma descrição precisa, defina inputs e formato do output, inclua regras de decisão e casos limite e mova referências extensas para fora de SKILL.md.

Trate scripts e recursos incluídos como inputs de software supply chain. Revise código, dependências, licenças, comportamento de rede, acesso a arquivos e tratamento de segredos. Verifique versões antes da distribuição em toda a empresa, especialmente quando houver execução de código.

Avalie skills com tarefas reais. Teste ativação correta, ativação falsa, qualidade do output, seleção de tools, contexto ausente, instruções inseguras e comportamento depois de updates. Registre owner, versão, compatibilidade, tools permitidas e caminho de depreciação.