Ir para o conteúdo principal
Zubnet AI › Aprender › Wiki › Agent Skills
Usar AI

Agent Skills

Também conhecido como: SKILL.md, Habilidades de agente
Pastas com instruções, scripts e recursos que um agente descobre sozinho e carrega apenas quando uma tarefa pede.

Por que isso importa

Modelos de uso geral são capazes, mas não conhecem os seus procedimentos: como a sua equipe formata relatórios, quais passos o seu deploy exige, como preencher um determinado formulário em PDF. Colocar tudo isso no prompt de sistema não escala, porque cada instrução custa contexto em toda requisição, seja relevante ou não.

As skills resolvem isso com divulgação progressiva. De início, o agente vê apenas o nome e a descrição de cada skill, cerca de 100 tokens cada. Quando uma tarefa corresponde, ele lê o SKILL.md completo. Se essas instruções mencionarem outro arquivo, ele só o abre se precisar. Um agente pode ter centenas de skills instaladas e não pagar quase nada até que uma seja usada.

Em profundidade

Uma skill de agente é uma pasta que ensina um agente de IA a fazer um tipo específico de tarefa. No centro dela há um arquivo, SKILL.md, que começa com um cabeçalho YAML curto (um nome e uma descrição) seguido de instruções em Markdown simples. A pasta também pode conter scripts, modelos de documentos e documentos de referência para os quais as instruções apontam.

A Anthropic lançou as Agent Skills para o Claude em outubro de 2025 e publicou o formato como padrão aberto em dezembro de 2025. Outras ferramentas de agentes, incluindo o Codex da OpenAI, o GitHub Copilot, o Cursor e o Gemini CLI, adotaram o formato desde então, de modo que a mesma pasta de skill pode funcionar em vários produtos.

Anatomia de uma skill

pdf-forms/
├── SKILL.md          # name, description, instructions
├── reference.md      # extra detail, read only if needed
└── scripts/
    └── fill_form.py  # code the agent can run

O cabeçalho no topo do SKILL.md tem dois campos obrigatórios:

name: pdf-forms
description: Fill in PDF forms. Use when the user asks to complete or extract fields from a PDF form.

A descrição é a linha mais importante. É tudo o que o modelo vê ao decidir se carrega a skill, então ela deve dizer tanto o que a skill faz quanto quando usá-la.

Código incluído

As skills podem trazer scripts. Isso importa porque algumas coisas são mais bem feitas por código do que gerando tokens: ordenar uma planilha, extrair campos de um formulário, validar uma saída. O agente executa o script e vê apenas o resultado, então o código em si nunca ocupa contexto. É também por isso que as skills precisam de um ambiente com sistema de arquivos e execução de código, como um agente de codificação ou um contêiner em sandbox.

Skills, MCP e prompts

  • MCP conecta um agente a ferramentas e dados externos: seu banco de dados, seu sistema de tickets. Ele dá ao agente novas capacidades.
  • As skills ensinam ao agente como fazer algo com as capacidades que ele já tem. Uma skill pode até descrever como usar bem um determinado servidor MCP.
  • Os prompts de sistema e os arquivos de instruções do projeto (como CLAUDE.md ou AGENTS.md) são sempre carregados. Servem para regras que valem o tempo todo, enquanto as skills servem para conhecimento que só é necessário às vezes.

Como escrever boas skills

Parta de falhas reais: observe onde o agente tem dificuldade em uma tarefa e depois anote o que estava faltando. Mantenha o SKILL.md curto e mova os detalhes para arquivos separados. Escreva para um novato inteligente: explique o que não é óbvio e pule o que o modelo já sabe. Teste tanto se a skill é acionada quando deveria quanto se ela fica quieta quando não deveria.

Segurança

Uma skill é um conjunto de instruções mais código executável, rodando com todo o acesso que o agente tiver. Uma skill maliciosa pode mandar o agente vazar dados ou executar comandos nocivos, o que faz dela uma injeção de prompt entregue como plugin. Instale skills apenas de fontes em que você confia e leia o que há dentro antes de ativá-las, principalmente scripts e qualquer coisa que acesse a rede.

← Todos os termos
ESC