Skills de agente

Bird publica agent skills: archivos de procedimiento empaquetados que enseñan a un agente de código los flujos de trabajo de bird CLI. Un skill proporciona el camino exitoso de la operación, las comprobaciones de estado que hay que ejecutar primero y las trampas que desperdician iteraciones del bucle. Esta guía ayuda al agente a llegar al comando correcto sin redescubrir flags y modos de fallo a partir de la salida de --help.

Se distribuyen como el plugin de marketplace de bird-ai, una sola fuente que Claude Code, Cursor, Codex y GitHub Copilot leen como plugin. Factory Droid, en cambio, copia los archivos de skill a mano (consulta Instalar el plugin). En Claude Code, instalar el plugin también registra el servidor MCP alojado, en el que luego inicias sesión una vez con /mcp (consulta Skills, el plugin y MCP).

Cada referencia codifica una operación por tarea. El agente elige la que coincide con la solicitud. Aparte del prerrequisito compartido de autenticación, no tienen un orden fijo.

Instalar el plugin

El marketplace se encuentra en messagebird/bird-ai. El plugin sigue la especificación Agent Plugins, así que un cliente que la implemente lo instala desde ese repositorio tal cual, skills y servidor MCP juntos.

Los pasos por cliente a continuación cubren el resto. En Claude Code, ejecuta:

Ejemplo de código

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

En Cursor, añade el marketplace e instala el plugin bird desde Settings > Plugins. En Codex, ejecuta codex plugin marketplace add messagebird/bird-ai y luego codex plugin add bird@bird-ai. En GitHub Copilot, ejecuta copilot plugin marketplace add messagebird/bird-ai y luego copilot plugin install bird@bird-ai. Factory Droid no tiene un formato de plugin que leer: clona messagebird/bird-ai y copia ambos directorios de skills de plugins/bird/skills/ a .factory/skills/ a mano.

Los skills

El plugin incluye dos skills.

bird-cli es el skill general. Enruta una solicitud a una referencia por grupo de comandos de CLI, de modo que el agente carga la página de la operación que tiene delante y nada más. Su tabla de enrutamiento abarca envío e inspección de mensajes en cada canal que Bird ejecuta, la configuración que cada canal necesita antes de poder enviar, verificación con código de un solo uso, búsqueda de destinatarios, contactos y audiencias, preferencias de mensajería, aprovisionamiento de Realtime, webhooks, claves API, tickets de soporte y búsqueda en la documentación. El propio SKILL.md del skill contiene esa tabla, y es la lista oficial: esta página deliberadamente no la copia, porque una segunda copia es una copia que se desactualiza.

Todas las entradas comparten un comportamiento que vale la pena mencionar aquí, porque es el que los agentes malinterpretan: un envío devuelve 202 con status: accepted, lo que significa que Bird aceptó el mensaje y la entrega aún está pendiente. Los skills enseñan al agente a releer el mensaje para obtener el resultado final en lugar de declarar éxito en accepted.

email-audit es un skill especializado. Ejecuta bird email tools audit <domain> para resolver y evaluar los registros DMARC, SPF, DKIM, BIMI y MX activos de un dominio, y luego lee los hallazgos etiquetados por severidad como una lista de correcciones priorizada. Solo usa DNS, así que no necesita autenticación ni envía correo.

El prerrequisito compartido: autenticarse primero

Casi todas las operaciones usan la Bird API en producción, así que bird-cli comienza cada una confirmando credenciales con bird auth status. La comprobación es idempotente y no hace nada cuando CLI ya reporta valid: true, de modo que es seguro ejecutarla siempre primero. Sin ella, la falta de inicio de sesión falla de forma idéntica a un error real de API y puede llevar al agente por un camino de depuración equivocado.

Las excepciones son las operaciones que leen algo público en lugar de tu espacio de trabajo: email-audit resuelve DNS y la búsqueda en la documentación lee los docs publicados. Ninguna necesita inicio de sesión ni se bloquea por la falta de uno.

Ejemplo de código

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

Si faltan credenciales, el skill dirige al agente a través de bird auth login y de vuelta a la tarea. La autenticación usa un navegador, con un flujo de código de dispositivo para hosts sin interfaz gráfica, así que el flujo de trabajo no se detiene en una solicitud de autenticación.

Los fallos aparecen de la misma forma en todas partes

Como cada operación es un envoltorio ligero sobre API en producción, los fallos llegan a través del contrato uniforme de CLI en lugar de un manejo de errores por skill:

JSON por defecto: Los éxitos imprimen JSON estructurado en stdout y los errores van a stderr, de modo que el bucle del agente puede analizar los resultados sin extraer texto.
Códigos de salida semánticos: uno de seis códigos indica al agente la categoría del fallo antes de que lea un mensaje. Consulta la tabla completa en CLI. El agente bifurca según la categoría sin analizar el mensaje: exit 4 significa volver a ejecutar el paso de autenticación, y exit 3 significa que el ID del recurso es incorrecto, así que reintentar no sirve.

Este es el mismo contrato que CLI presenta a humanos y scripts. Los skills no añaden ninguna capa; enseñan al agente a usar el contrato existente. Consulta CLI para agentes para ver el contrato completo, incluidos formatos de salida y configuración.

Componer skills en un bucle de agente

Como cada referencia es una operación autovalidable con un resultado legible por máquina, se componen en un bucle sin código de unión. Por ejemplo, "send the launch email and confirm it delivered" se descompone así:

Autenticarse: Ejecuta bird auth status; inicia sesión solo si es necesario.
Encontrar un remitente: Usa la referencia de dominios para elegir una dirección from en un dominio verificado. Exit 0 más un dominio verificado en JSON significa que este paso está completo; de lo contrario, entra en el bucle de creación y verificación.
Enviar: Usa la referencia de email para ejecutar bird email send …. Una solicitud exitosa devuelve 202, un ID de em_… y status: accepted.
Confirmar el resultado: Usa la referencia de email de nuevo para ejecutar bird email get <em_…> hasta que los contadores muestren delivered. Si muestran bounced, reporta el fallo.

La condición "done when" de cada paso es verificable a partir de la salida JSON del paso anterior, y eso es lo que hace fiable el bucle: el agente nunca tiene que inferir estado a partir de texto.

Skills, el plugin y MCP

Los skills son una de tres formas de conectar un agente con Bird, y se complementan en lugar de competir:

bird CLI es la superficie de ejecución. Los skills asumen un agente con acceso a shell que puede ejecutarlo.
El servidor MCP es la alternativa para agentes que llaman herramientas en lugar de ejecutar comandos; las operaciones son equivalentes, el transporte difiere.
AI onboarding es la ruta de configuración guiada que conecta cualquiera de los dos en minutos.

Que la instalación del plugin también configure el servidor MCP depende del cliente. Claude Code permite que un plugin declare un servidor MCP remoto, así que instalar bird-ai ahí registra https://mcp.bird.com por ti. El plugin de OpenCode también registra el servidor: https://mcp.bird.com/dynamic por defecto, o el https://mcp.bird.com completo con el modo experimental de código de OpenCode activado. Otros clientes admiten MCP remoto, pero sus plugins no pueden predeclarar un servidor. En Cursor, Codex y Copilot, el plugin instala las skills; en Droid, copias los archivos de skill a mano. Esos clientes necesitan que el servidor se añada manualmente, usando la configuración de una línea en la guía del servidor MCP.

Lo que ningún plugin puede hacer es autenticarte. El servidor alojado está protegido por OAuth, así que en todos los clientes, incluido Claude Code, inicias sesión una vez después de registrar el servidor: en Claude Code eso es /mcp, luego selecciona bird y después Authenticate. Hasta que lo hagas, las herramientas aparecen listadas y cada llamada falla. Los pasos de autenticación por cliente cubren el resto.

Cliente	Skills vía plugin	Servidor MCP registrado	Inicio de sesión
Claude Code	Sí	Sí, declarado por el plugin	Tú: /mcp > bird > Authenticate
Cursor	Sí	Manual, añade el servidor remoto una vez	Tú: Needs login en Tools & Integrations
Codex	Sí	Manual, añade el servidor remoto una vez	Tú: codex mcp login bird
GitHub Copilot	Sí	Manual, añade el servidor remoto una vez	VS Code abre el navegador en el primer inicio
Factory Droid	Manual, copia los archivos de skill	Manual, añade el servidor remoto una vez	Tú: /mcp dentro de droid
OpenCode	Sí	Sí, declarado por el plugin	Tú: opencode mcp auth bird

Próximos pasos

Configura tu agente de código: la configuración de un solo prompt que instala el plugin por ti.
Servidor MCP: la superficie de herramientas que incluye el plugin y cómo añadirlo manualmente.
CLI para agentes: la superficie de comandos que enseñan los skills, para agentes con acceso a shell.
AI onboarding: la configuración guiada de extremo a extremo con el corpus de docs conectado.

Recursos relacionados

Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.

Ver la guíaSetting up your coding agent Comprender el conceptoWhat is an MCP server, and how does an agent use one to send messages?Explorar la funcionalidadCoding agents Seguir la ruta de aprendizajeBuild with AI agents

Obtener un resumen de implementación