Skills de agente

O Bird publica skills de agente: arquivos de procedimento empacotados que ensinam a um agente de código os fluxos de trabalho do bird CLI. Uma skill fornece o caminho feliz da operação, as verificações de estado a executar primeiro e as armadilhas que desperdiçam iterações do loop. Essa orientação ajuda o agente a chegar ao comando correto sem redescobrir flags e modos de falha pela saída do --help.

Elas são distribuídas como o plugin do marketplace bird-ai, uma única fonte que Claude Code, Cursor, Codex e GitHub Copilot leem como plugin. O Factory Droid, em vez disso, copia os arquivos de skill manualmente (veja Instalar o plugin). No Claude Code, instalar o plugin também registra o servidor MCP hospedado, no qual você faz login uma vez com /mcp (veja Skills, o plugin e MCP).

Cada referência codifica uma operação por tarefa. O agente escolhe a que corresponde à solicitação. Exceto pelo pré-requisito compartilhado de autenticação, elas não têm ordem.

Instalar o plugin

O marketplace fica em messagebird/bird-ai. O plugin segue o padrão Agent Plugins, então um cliente que implementa a especificação o instala diretamente desse repositório, skills e servidor MCP juntos.

As etapas por cliente abaixo cobrem o restante. No Claude Code, execute:

Exemplo de código

claude plugin marketplace add messagebird/bird-ai
claude plugin install bird@bird-ai

No Cursor, adicione o marketplace e instale o plugin bird em Settings > Plugins. No Codex, execute codex plugin marketplace add messagebird/bird-ai e depois codex plugin add bird@bird-ai. No GitHub Copilot, execute copilot plugin marketplace add messagebird/bird-ai e depois copilot plugin install bird@bird-ai. O Factory Droid não tem formato de plugin para ler: clone messagebird/bird-ai e copie os dois diretórios de skill de plugins/bird/skills/ para .factory/skills/ manualmente.

As skills

Duas skills são distribuídas no plugin.

bird-cli é a skill geral. Ela roteia uma solicitação para uma referência por grupo de comandos do CLI, de modo que o agente carrega a página da operação à sua frente e nada mais. Sua tabela de roteamento abrange envio e inspeção de mensagens em todos os canais que o Bird opera, a configuração que cada canal precisa antes de poder enviar, verificação de código de uso único, busca de destinatários, contatos e audiências, preferências de mensagens, provisionamento Realtime, webhooks, chaves API, tickets de suporte e busca na documentação. O próprio SKILL.md da skill contém essa tabela, e ela é a lista oficial: esta página deliberadamente não a copia, porque uma segunda cópia é uma cópia que fica desatualizada.

Todas as entradas compartilham um hábito que vale mencionar aqui, porque é o que os agentes erram: um envio retorna 202 com status: accepted, o que significa que o Bird aceitou a mensagem e a entrega ainda está pendente. As skills ensinam o agente a consultar a mensagem novamente para obter o resultado final em vez de declarar sucesso em accepted.

email-audit é uma skill especialista. Ela executa bird email tools audit <domain> para resolver e avaliar os registros DMARC, SPF, DKIM, BIMI e MX ativos de um domínio, e depois lê os achados com tags de severidade como uma lista priorizada de correções. É somente DNS, então não precisa de autenticação e não envia e-mail.

O pré-requisito compartilhado: autentique primeiro

Quase toda operação acessa a Bird API ao vivo, então o bird-cli inicia cada uma confirmando credenciais com bird auth status. A verificação é idempotente e não faz nada quando o CLI já informa valid: true, então é seguro executá-la primeiro todas as vezes. Sem ela, um login ausente falha de forma idêntica a um erro real de API e pode levar o agente pelo caminho de depuração errado.

As exceções são as operações que leem algo público em vez do seu espaço de trabalho: email-audit resolve DNS, e a busca na documentação lê os docs publicados. Nenhuma precisa de login, e nenhuma é bloqueada por um login ausente.

Exemplo de código

bird auth status --format json
# gate on "valid": true, then run the operation

Se as credenciais estiverem ausentes, a skill roteia o agente pelo bird auth login e de volta à tarefa. A autenticação usa um navegador, com fluxo de código de dispositivo para hosts sem interface gráfica, então o fluxo de trabalho não trava em um prompt de autenticação.

Falhas aparecem da mesma forma em todo lugar

Como toda operação é um wrapper fino sobre o API ao vivo, as falhas retornam pelo contrato uniforme do CLI em vez de tratamento de erros por skill:

JSON por padrão: Sucessos imprimem JSON estruturado em stdout e erros vão para stderr, de modo que o loop do agente consegue analisar resultados sem extrair texto em prosa.
Códigos de saída semânticos: um de seis códigos informa ao agente a categoria da falha antes que ele leia a mensagem. Veja a tabela completa em CLI. O agente decide com base na categoria sem analisar a mensagem: exit 4 significa reexecutar a etapa de autenticação, e exit 3 significa que o ID do recurso está errado, então tentar novamente não ajuda.

Este é o mesmo contrato que o CLI apresenta a humanos e scripts. As skills não adicionam nenhuma camada; elas ensinam o agente a usar o contrato existente. Veja CLI para agentes para o contrato completo, incluindo formatos de saída e configuração.

Compondo skills em um loop de agente

Como cada referência é uma operação autovalidada com resultado legível por máquina, elas se compõem em um loop sem código de cola. Por exemplo, "send the launch email and confirm it delivered" se decompõe assim:

Autenticar: Execute bird auth status; faça login apenas se necessário.
Encontrar um remetente: Use a referência de domínios para escolher um endereço from em um domínio verificado. Exit 0 mais um domínio verificado no JSON significa que esta etapa está completa; caso contrário, entre no loop de criação e verificação.
Enviar: Use a referência de e-mail para executar bird email send …. Uma solicitação bem-sucedida retorna 202, um ID em_… e status: accepted.
Confirmar o resultado: Use a referência de e-mail novamente para executar bird email get <em_…> até que os contadores mostrem delivered. Se mostrarem bounced, reporte a falha.

A condição de "done when" de cada etapa é verificável a partir da saída JSON da etapa anterior, e é isso que torna o loop confiável: o agente nunca precisa inferir estado a partir de texto em prosa.

Skills, o plugin e MCP

Skills são uma de três formas de apontar um agente para o Bird, e elas se complementam em vez de competir:

O bird CLI é a superfície de execução. As skills pressupõem um agente com acesso a shell que possa executá-lo.
O servidor MCP é a alternativa para agentes que chamam ferramentas em vez de executar comandos; as operações são equivalentes, o transporte difere.
AI onboarding é o caminho guiado de configuração que conecta qualquer uma das opções em minutos.

Se a instalação do plugin também configura o servidor MCP depende do cliente. O Claude Code permite que um plugin declare um servidor MCP remoto, então instalar bird-ai lá registra https://mcp.bird.com para você. O plugin do OpenCode também registra o servidor: https://mcp.bird.com/dynamic por padrão, ou o https://mcp.bird.com completo com o modo de código experimental do OpenCode ativado. Outros clientes suportam MCP remoto, mas seus plugins não conseguem pré-declarar um servidor. No Cursor, Codex e Copilot, o plugin instala as skills; no Droid, você copia os arquivos de skill manualmente. Esses clientes precisam que o servidor seja adicionado manualmente, usando a configuração de uma linha no guia do servidor MCP.

O que nenhum plugin pode fazer é autenticar por você. O servidor hospedado é protegido por OAuth, então em todo cliente, incluindo o Claude Code, você faz login uma vez após o servidor ser registrado: no Claude Code, isso é /mcp, selecione bird e depois Authenticate. Até que você faça isso, as ferramentas ficam listadas e toda chamada falha. As etapas de autenticação por cliente cobrem o restante.

Cliente	Skills via plugin	Servidor MCP registrado	Login
Claude Code	Sim	Sim, declarado pelo plugin	Você: /mcp > bird > Authenticate
Cursor	Sim	Manual, adicione o servidor remoto uma vez	Você: Needs login em Tools & Integrations
Codex	Sim	Manual, adicione o servidor remoto uma vez	Você: codex mcp login bird
GitHub Copilot	Sim	Manual, adicione o servidor remoto uma vez	O VS Code abre o navegador na primeira execução
Factory Droid	Manual, copie os arquivos de skill	Manual, adicione o servidor remoto uma vez	Você: /mcp dentro do droid
OpenCode	Sim	Sim, declarado pelo plugin	Você: opencode mcp auth bird

Próximos passos

Configure seu agente de código: a configuração de um único prompt que instala o plugin para você.
Servidor MCP: a superfície de ferramentas que o plugin inclui, e como adicioná-la manualmente.
CLI para agentes: a superfície de comandos que as skills ensinam, para agentes com acesso a shell.
AI onboarding: a configuração guiada de ponta a ponta com o corpus de documentação conectado.

Recursos relacionados

Continue com a documentação, guias e exemplos sobre este tópico. Os recursos estão em inglês.

Assista ao guiaSetting up your coding agent Entenda o conceitoWhat is an MCP server, and how does an agent use one to send messages?Explore a funcionalidadeCoding agents Siga o percurso de aprendizagemBuild with AI agents

Obtenha um resumo de implementação