Como funciona
O protocolo Agent Skills define um ciclo de vida simples para como os agentes interagem com as habilidades:
1. Descoberta (Discovery)
Na inicialização, os agentes carregam apenas os metadados leves (nome e descrição) de cada habilidade disponível. Isso mantém a janela de contexto limpa e eficiente.
2. Ativação (Activation)
Quando a solicitação de um usuário corresponde à descrição de uma habilidade, o agente a "ativa" lendo o conjunto completo de instruções do arquivo de definição da habilidade.
3. Execução (Execution)
O agente segue as instruções passo a passo fornecidas pela habilidade, que podem envolver a execução de código, processamento de arquivos ou chamada de APIs externas.
Estrutura de Diretório
As habilidades são organizadas em uma estrutura de diretório simples. Cada habilidade vive em sua própria pasta e requer um arquivo `SKILL.md` correto.
skill-name/
└── SKILL.md # Required: The main definition file
└── scripts/ # Optional: Helper scripts (Python, Node, etc.)
└── references/ # Optional: Text files for RAG
└── assets/ # Optional: Images or templatesO Padrão SKILL.md
No coração de cada habilidade está um arquivo `SKILL.md`. Ele combina YAML frontmatter para metadados com Markdown legível por humanos para instruções. Este formato de "Dupla Audiência" serve tanto ao agente de IA quanto aos desenvolvedores humanos.
---
name: pdf-processing
description: Extract text and tables from PDF files.
---
# PDF Processing
## When to use this skill
Use this skill when the user needs to work with PDF files...
## How to extract text
1. Use `pdfplumber` for text extraction...Por que usar Agent Skills?
Autodocumentável
As instruções para o agente SÃO a documentação para o desenvolvedor.
Portátil
Habilidades são apenas arquivos. Elas são fáceis de controlar versão, compartilhar e editar.
Universal
Funciona com qualquer LLM e qualquer estrutura de agente que suporte a especificação.
Seguro
Execução em sandbox e escopos de permissão explícitos.
Comece a Explorar
Pronto para ver o que é possível? Navegue no mercado para descobrir centenas de habilidades contribuídas pela comunidade.