Agent-Skills

Bird veröffentlicht Agent-Skills: paketierte Prozedurdateien, die einem Coding-Agenten die bird-CLI-Workflows beibringen. Ein Skill liefert den Happy Path der Operation, die vorab auszuführenden Zustandsprüfungen und die Fallstricke, die Schleifeniterationen verschwenden. Diese Anleitung hilft dem Agenten, ohne das Neu-Entdecken von Flags und Fehlermodi aus der --help-Ausgabe zum korrekten Befehl zu gelangen.

Sie werden als bird-ai-Marketplace-Plugin ausgeliefert, eine einzige Quelle, die Claude Code, Cursor, Codex und GitHub Copilot jeweils als Plugin lesen. Factory Droid kopiert die Skill-Dateien stattdessen manuell hinein (siehe Plugin installieren). Bei Claude Code registriert die Installation des Plugins zusätzlich den gehosteten MCP-Server, bei dem Sie sich dann einmalig mit /mcp anmelden (siehe Skills, das Plugin und MCP).

Jede Referenz kodiert eine Operation pro Aufgabe. Der Agent wählt diejenige aus, die zur Anfrage passt. Abgesehen von der gemeinsamen Authentifizierungsvoraussetzung gibt es keine Reihenfolge.

Plugin installieren

Der Marketplace befindet sich unter messagebird/bird-ai. Das Plugin folgt Agent Plugins, sodass ein Client, der die Spezifikation implementiert, es unverändert aus diesem Repository installiert, Skills und MCP-Server zusammen.

Die clientspezifischen Schritte unten decken den Rest ab. Bei Claude Code führen Sie aus:

Codebeispiel

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

Bei Cursor fügen Sie den Marketplace hinzu und installieren das bird-Plugin über Settings > Plugins. Bei Codex führen Sie codex plugin marketplace add messagebird/bird-ai aus, dann codex plugin add bird@bird-ai. Bei GitHub Copilot führen Sie copilot plugin marketplace add messagebird/bird-ai aus, dann copilot plugin install bird@bird-ai. Factory Droid hat kein Plugin-Format zum Lesen: Klonen Sie messagebird/bird-ai und kopieren Sie beide Skill-Verzeichnisse aus plugins/bird/skills/ manuell nach .factory/skills/.

Die Skills

Zwei Skills werden mit dem Plugin ausgeliefert.

bird-cli ist der allgemeine. Er leitet eine Anfrage an eine Referenz pro CLI-Befehlsgruppe weiter, sodass der Agent die Seite für die vorliegende Operation lädt und nichts anderes. Seine Routing-Tabelle umfasst das Senden und Prüfen von Nachrichten auf jedem Kanal, den Bird betreibt, die Einrichtung, die jeder Kanal vor dem Senden benötigt, Einmalpasscode-Verifizierung, Empfänger-Lookup, Kontakte und Audiences, Messaging-Präferenzen, Realtime-Provisionierung, Webhooks, API-Keys, Support-Tickets und Dokumentationssuche. Die SKILL.md des Skills enthält diese Tabelle und ist die maßgebliche Liste: Diese Seite kopiert sie bewusst nicht, da eine zweite Kopie eine Kopie ist, die veraltet.

Alle Einträge teilen eine Gewohnheit, die hier erwähnenswert ist, weil es diejenige ist, die Agenten falsch machen: Ein Senden gibt 202 mit status: accepted zurück, was bedeutet, dass Bird die Nachricht angenommen hat und die Zustellung noch aussteht. Die Skills bringen dem Agenten bei, die Nachricht erneut abzurufen, um das endgültige Ergebnis zu erfahren, anstatt bei accepted den Erfolg zu verkünden.

email-audit ist ein Spezialist. Er führt bird email tools audit <domain> aus, um die Live-DMARC-, SPF-, DKIM-, BIMI- und MX-Einträge einer Domain aufzulösen und zu bewerten, und liest dann die nach Schweregrad getaggten Befunde als priorisierte Fix-Liste zurück. Er ist rein DNS-basiert, benötigt daher keine Authentifizierung und sendet keine E-Mails.

Die gemeinsame Voraussetzung: Zuerst authentifizieren

Fast jede Operation trifft die Live-Bird-API, daher beginnt bird-cli jede Operation damit, Anmeldedaten mit bird auth status zu bestätigen. Die Prüfung ist idempotent und tut nichts, wenn die CLI bereits valid: true meldet, daher ist es sicher, sie jedes Mal zuerst auszuführen. Ohne sie schlägt ein fehlender Login identisch wie ein echter API-Fehler fehl und kann den Agenten auf den falschen Debugging-Pfad schicken.

Die Ausnahmen sind Operationen, die etwas Öffentliches lesen statt Ihren Workspace: email-audit löst DNS auf, und die Dokumentationssuche liest die veröffentlichten Docs. Keine von beiden benötigt einen Login, und keine von beiden wird durch einen fehlenden blockiert.

Codebeispiel

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

Falls Anmeldedaten fehlen, leitet der Skill den Agenten durch bird auth login und zurück zur Aufgabe. Die Authentifizierung nutzt einen Browser, mit einem Device-Code-Flow für Headless-Hosts, sodass der Workflow nicht an einem Authentifizierungs-Prompt hängen bleibt.

Fehler werden überall gleich angezeigt

Da jede Operation ein dünner Wrapper über die Live-API ist, kommen Fehler über den einheitlichen Vertrag der CLI zurück, nicht über skill-spezifische Fehlerbehandlung:

Standardmäßig JSON: Erfolge geben strukturiertes JSON auf stdout aus und Fehler gehen auf stderr, sodass die Schleife des Agenten Ergebnisse parsen kann, ohne Prosa zu durchsuchen.
Semantische Exit-Codes: Einer von sechs Codes teilt dem Agenten die Fehlerkategorie mit, bevor er eine Nachricht liest. Die vollständige Tabelle finden Sie unter CLI. Der Agent verzweigt anhand der Kategorie, ohne die Nachricht zu parsen: Exit 4 bedeutet, den Authentifizierungsschritt erneut auszuführen, und Exit 3 bedeutet, die Ressourcen-ID ist falsch, sodass ein erneuter Versuch nicht hilft.

Dies ist derselbe Vertrag, den die CLI Menschen und Skripten präsentiert. Die Skills fügen keine Schicht hinzu; sie bringen dem Agenten bei, den bestehenden Vertrag zu nutzen. Siehe CLI für Agenten für den vollständigen Vertrag, einschließlich Ausgabeformate und Konfiguration.

Skills zu einer Agentenschleife zusammensetzen

Da jede Referenz eine einzelne selbstprüfende Operation mit maschinenlesbarem Ergebnis ist, lassen sie sich ohne Glue-Code zu einer Schleife zusammensetzen. Zum Beispiel zerlegt sich „Sende die Launch-E-Mail und bestätige die Zustellung" wie folgt:

Authentifizieren: bird auth status ausführen; nur bei Bedarf anmelden.
Absender finden: Die Domains-Referenz verwenden, um eine from-Adresse auf einer verifizierten Domain auszuwählen. Exit 0 plus eine verifizierte Domain im JSON bedeutet, dass dieser Schritt abgeschlossen ist; andernfalls in die Erstellen-und-Verifizieren-Schleife eintreten.
Senden: Die E-Mail-Referenz verwenden, um bird email send … auszuführen. Eine erfolgreiche Anfrage gibt 202, eine em_…-ID und status: accepted zurück.
Ergebnis bestätigen: Die E-Mail-Referenz erneut verwenden, um bird email get <em_…> auszuführen, bis die Zähler delivered anzeigen. Falls sie bounced anzeigen, den Fehler melden.

Die „Fertig wenn"-Bedingung jedes Schritts ist aus der JSON-Ausgabe des vorherigen Schritts prüfbar, und genau das macht die Schleife zuverlässig: Der Agent muss niemals Zustand aus Prosa ableiten.

Skills, das Plugin und MCP

Skills sind eine von drei Möglichkeiten, einen Agenten auf Bird auszurichten, und sie ergänzen sich, anstatt zu konkurrieren:

Die bird-CLI ist die Ausführungsebene. Skills setzen einen shell-fähigen Agenten voraus, der sie ausführen kann.
Der MCP-Server ist die Alternative für Agenten, die Tools aufrufen, anstatt Befehle auszuführen; die Operationen sind äquivalent, der Transport unterscheidet sich.
AI-Onboarding ist der geführte Einrichtungspfad, der eines von beiden in wenigen Minuten verbindet.

Ob die Plugin-Installation auch den MCP-Server konfiguriert, hängt vom Client ab. Claude Code erlaubt einem Plugin, einen Remote-MCP-Server zu deklarieren, sodass die Installation von bird-ai dort https://mcp.bird.com für Sie registriert. Andere Clients unterstützen Remote-MCP, aber ihre Plugins können keinen Server vorab deklarieren. Bei Cursor, Codex und Copilot installiert das Plugin die Skills; bei Droid kopieren Sie die Skill-Dateien manuell hinein. Jeder Client außer Claude Code benötigt den Server manuell hinzugefügt, unter Verwendung der einzeiligen Konfiguration im MCP-Server-Leitfaden.

Was kein Plugin für Sie tun kann, ist die Authentifizierung. Der gehostete Server ist OAuth-geschützt, daher melden Sie sich bei jedem Client, einschließlich Claude Code, einmalig an, nachdem der Server registriert ist: Bei Claude Code ist das /mcp, dann bird auswählen, dann Authenticate. Bis Sie das tun, werden die Tools aufgelistet und jeder Aufruf schlägt fehl. Die clientspezifischen Authentifizierungsschritte decken den Rest ab.

Client	Skills via Plugin	MCP-Server registriert	Anmeldung
Claude Code	Ja	Ja, vom Plugin deklariert	Sie: /mcp > bird > Authenticate
Cursor	Ja	Manuell, Remote-Server einmal hinzufügen	Sie: Needs login in Tools & Integrations
Codex	Ja	Manuell, Remote-Server einmal hinzufügen	Sie: codex mcp login bird
GitHub Copilot	Ja	Manuell, Remote-Server einmal hinzufügen	VS Code öffnet den Browser beim ersten Start
Factory Droid	Manuell, Skill-Dateien hineinkopieren	Manuell, Remote-Server einmal hinzufügen	Sie: /mcp innerhalb von Droid

Nächste Schritte

Ihren Coding-Agenten einrichten: das Ein-Prompt-Setup, das das Plugin für Sie installiert.
MCP-Server: die Tool-Oberfläche, die das Plugin bündelt, und wie man sie manuell hinzufügt.
CLI für Agenten: die Befehlsoberfläche, die die Skills lehren, für shell-fähige Agenten.
AI-Onboarding: der geführte, durchgängige Einrichtungspfad mit eingebundenem Docs-Korpus.