Enviar uma mensagem envolve mais do que escolher uma função de envio. O agente também precisa de um remetente, permissão para enviar e uma forma de verificar o resultado.
Uma skill pode descrever esse procedimento para que o agente tenha instruções para a tarefa completa.
O que uma skill contém?
Uma skill contém um arquivo SKILL.md com metadados e instruções. Ela pode incluir arquivos de apoio para a tarefa.
A especificação Agent Skills exige um nome e uma descrição no frontmatter do arquivo. A descrição informa ao host quando a skill se aplica. O corpo em Markdown contém o procedimento.
Diretórios de apoio podem conter scripts executáveis, material de referência e recursos como templates. Eles permitem que o agente busque material detalhado quando a tarefa precisar.
Por exemplo, uma skill de envio de mensagens poderia descrever como selecionar um remetente e verificar a entrega. Uma referência poderia explicar os campos da resposta. As instruções da skill conectariam essas etapas em uma única tarefa.
Como o agente carrega a skill?
O host descobre os metadados da skill e então carrega suas instruções quando a tarefa corresponde.
A especificação chama isso de divulgação progressiva. O host pode carregar arquivos de apoio depois, mantendo material não relacionado fora do contexto inicial.
A visão geral de skills da Anthropic ilustra isso com níveis separados para metadados, instruções e recursos de apoio. O host precisa implementar a descoberta e o carregamento de skills para que esse comportamento aconteça. Colocar um arquivo em disco sozinho não garante que o agente o utilizou.
Qual a diferença entre uma skill e uma tool?
Uma skill descreve um procedimento. Uma tool expõe uma ação que a aplicação do agente pode executar.
| Componente | Papel em uma tarefa de envio de mensagem |
|---|---|
| Skill | Descreve os pré-requisitos, a etapa de envio e a verificação do resultado |
| Tool | Envia uma mensagem ou consulta o status registrado |
| Servidor MCP | Expõe tools e outras capacidades por meio de um protocolo |
A especificação MCP define a interface cliente-servidor. Uma skill pode ensinar um agente a usar essa interface ou um CLI.
Instruções não emitem credenciais. A aplicação ainda precisa de permissão para executar a ação solicitada. Uma resposta de tool bem-sucedida também precisa de interpretação: aceitação e entrega descrevem resultados diferentes.
Como uso skills com Bird?
Você pode instalar as agent skills de Bird para fornecer a um agente de codificação procedimentos para Bird CLI.
A skill geral instrui o agente a verificar a autenticação antes de operações no espaço de trabalho. Seu fluxo de mensagens inclui selecionar um remetente, enviar e ler a mensagem resultante de volta. O agente precisa desse resultado antes de poder reportar a entrega.
Skills e credenciais têm etapas de instalação separadas. Instalar um plugin não concede acesso ao seu espaço de trabalho. Conclua o login documentado antes de pedir que o agente atue.
Para um host que invoca tools, conecte o servidor MCP de Bird. Para um agente com acesso a shell, o guia CLI descreve a saída de comando que a skill usa para verificar cada etapa.