Habilidades do agente

Bird publica habilidades do agente: arquivos de procedimento empacotados que ensinam a um agente de codificação os fluxos de trabalho da CLI bird. Uma habilidade 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 a um comando correto sem redescobrir flags e modos de falha a partir da saída de --help.

Elas são distribuídas como o plugin de 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 habilidade manualmente (veja Instalar o plugin). No Claude Code, instalar o plugin também registra o servidor MCP hospedado, no qual você então faz login uma vez com /mcp (veja Habilidades, o plugin e MCP).

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

Instalar o plugin

O marketplace está em messagebird/bird-ai. O plugin segue o Agent Plugins, então um cliente que implementa a especificação o instala a partir desse repositório como está, habilidades e servidor MCP juntos.

Os passos 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, depois codex plugin add bird@bird-ai. No GitHub Copilot, execute copilot plugin marketplace add messagebird/bird-ai, depois copilot plugin install bird@bird-ai. O Factory Droid não tem formato de plugin para ler: clone messagebird/bird-ai e copie ambos os diretórios de habilidade de plugins/bird/skills/ para .factory/skills/ manualmente.

As habilidades

Duas habilidades são distribuídas no plugin.

bird-cli é a geral. Ela roteia uma solicitação para uma referência por grupo de comandos da CLI, para que o agente carregue 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 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, API keys, tickets de suporte e busca na documentação. O próprio SKILL.md da habilidade contém essa tabela, e ele é a lista oficial: esta página deliberadamente não a copia, porque uma segunda cópia é uma cópia que fica desatualizada.

Toda entrada compartilha um hábito que vale a pena mencionar aqui, porque é o que os agentes erram: um envio retorna 202 com status: accepted, o que significa que Bird aceitou a mensagem e a entrega ainda está pendente. As habilidades ensinam o agente a ler a mensagem de volta para o resultado final em vez de declarar sucesso em accepted.

email-audit é uma 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, depois lê as descobertas marcadas por severidade de volta como uma lista priorizada de correções. É apenas DNS, então não precisa de autenticação e não envia nenhum e-mail.

O pré-requisito compartilhado: autenticar primeiro

Quase toda operação acessa a API Bird em produção, então bird-cli inicia cada uma confirmando credenciais com bird auth status. A verificação é idempotente e não faz nada quando a CLI já reporta valid: true, então é seguro executar primeiro toda vez. Sem ela, um login ausente falha de forma idêntica a um erro real da API e pode enviar 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 workspace: email-audit resolve DNS, e a busca na documentação lê os docs publicados. Nenhuma precisa de login, e nenhuma é bloqueada pela ausência de um.

Exemplo de código

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

Se as credenciais estiverem ausentes, a habilidade direciona o agente por bird auth login e de volta à tarefa. A autenticação usa um navegador, com um 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 todos os lugares

Como toda operação é um wrapper fino sobre a API em produção, as falhas retornam através do contrato uniforme da CLI em vez de tratamento de erros por habilidade:

JSON por padrão: Sucessos imprimem JSON estruturado em stdout e erros vão para stderr, então o loop do agente pode analisar resultados sem raspar texto livre.
Códigos de saída semânticos: um de seis códigos informa ao agente a categoria da falha antes que ele leia uma mensagem. Veja a tabela completa em CLI. O agente faz ramificação pela categoria sem analisar a mensagem: saída 4 significa reexecutar o passo de autenticação, e saída 3 significa que o ID do recurso está errado, então tentar novamente não vai ajudar.

Este é o mesmo contrato que a CLI apresenta a humanos e scripts. As habilidades 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 habilidades em um loop de agente

Como cada referência é uma operação auto-verificável com um resultado legível por máquina, elas se compõem em um loop sem código de ligação. Por exemplo, "envie o e-mail de lançamento e confirme que foi entregue" se decompõe da seguinte forma:

Autenticar: Execute bird auth status; fazer 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. Saída 0 mais um domínio verificado no JSON significa que esta etapa está completa; caso contrário, entre no loop de criar-e-verificar.
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 "concluído quando" de cada etapa é verificável a partir da saída JSON da etapa anterior, que é o que torna o loop confiável: o agente nunca precisa inferir estado a partir de texto livre.

Habilidades, o plugin e MCP

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

A CLI bird é a superfície de execução. As habilidades assumem um agente capaz de usar shell que pode executá-la.
O servidor MCP é a alternativa para agentes que chamam ferramentas em vez de executar comandos; as operações são equivalentes, o transporte é diferente.
O onboarding de IA é o caminho de configuração guiado que conecta qualquer um dos dois 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 o bird-ai lá registra https://mcp.bird.com para você. Os outros clientes suportam MCP remoto, mas seus plugins não podem pré-declarar um servidor. No Cursor, Codex e Copilot, o plugin instala as habilidades; no Droid, você copia os arquivos de habilidade manualmente. Todos os clientes exceto o Claude Code 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 todos os clientes, incluindo Claude Code, você faz login uma vez após o servidor ser registrado: no Claude Code isso é /mcp, depois selecione bird, depois Authenticate. Até que você faça isso, as ferramentas são listadas e toda chamada falha. Os passos de autenticação por cliente cobrem o restante.

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

Próximos passos

Configure seu agente de codificação: a configuração de um prompt que instala o plugin para você.
Servidor MCP: a superfície de ferramentas que o plugin inclui, e como adicioná-lo manualmente.
CLI para agentes: a superfície de comandos que as habilidades ensinam, para agentes capazes de usar shell.
Onboarding de IA: a configuração guiada de ponta a ponta com o corpus de documentação integrado.

Related resources

Continue with the documentation, guides and examples for this topic. Resources are in English.

Watch the guideSetting up your coding agent Understand the conceptWhat is an MCP server, and how does an agent use one to send messages?Explore the capabilityCoding agents Follow the learning pathBuild with AI agents

Get an implementation brief