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.