Agent Skills

Bird veröffentlicht Agent Skills: paketierte Prozedurdateien, die einem Coding-Agent die bird CLI-Workflows beibringen. Ein Skill liefert den Happy Path der Operation, die vorab nötigen Statusprüfungen und die Fallstricke, die Schleifendurchläufe verschwenden. So erreicht der Agent einen korrekten Befehl, ohne Flags und Fehlerfälle aus der --help-Ausgabe neu zu entdecken.

Sie werden als bird-ai-Marketplace-Plugin ausgeliefert, eine einzige Quelle, die Claude Code, Cursor, Codex und GitHub Copilot jeweils als Plugin lesen. Antigravity installiert ein Paket aus derselben Quelle, und Factory Droid kopiert die Skill-Dateien von Hand hinein (siehe Plugin installieren). Bei Claude Code registriert die Plugin-Installation auch 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, 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:

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

Fügen Sie in Cursor Bird über den Cursor Marketplace hinzu oder führen Sie /add-plugin bird aus. Sie können den Marketplace auch unter Settings > Plugins hinzufügen und das bird-Plugin von dort installieren. Installieren Sie für ChatGPT und Codex Bird in Codex oder ChatGPT. Melden Sie sich bei Ihrem Bird-Workspace an und bitten Sie Ihren Agenten, mit Bird zu arbeiten. Alternativ im Terminal: Führen Sie codex plugin marketplace add messagebird/bird-ai und dann codex plugin add bird@bird-ai aus. Führen Sie für GitHub Copilot copilot plugin marketplace add messagebird/bird-ai und dann copilot plugin install bird@bird-ai aus. Führen Sie für Antigravity curl -fsSL https://raw.githubusercontent.com/messagebird/bird-ai/main/antigravity.sh | bash aus – das Plugin wird in ~/.gemini/config/plugins/bird für jeden Workspace installiert. Die Repository-README beschreibt eine projektbezogene Installation und Antigravity CLI. Factory Droid hat kein Plugin-Format: Klonen Sie messagebird/bird-ai und kopieren Sie beide Skill-Verzeichnisse aus plugins/bird/skills/ manuell nach .factory/skills/.

Die Skills

Zwei Skills sind im Plugin enthalten.

bird-cli ist der allgemeine Skill. Er leitet eine Anfrage an eine Referenz pro CLI-Befehlsgruppe weiter, sodass der Agent die Seite für die aktuelle Operation lädt und nichts anderes. Seine Routing-Tabelle umfasst das Senden und Prüfen von Nachrichten auf jedem Kanal, den Bird unterstützt, das Setup, das jeder Kanal vor dem Senden braucht, Einmalpasscode-Verifizierung, Empfängersuche, Kontakte und Zielgruppen, Messaging-Präferenzen, Realtime-Provisioning, Webhooks, API-Schlüssel, 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, weil eine zweite Kopie eine Kopie ist, die veraltet.

Jeder Eintrag teilt eine Eigenheit, die hier erwähnenswert ist, weil Agents sie falsch machen: Ein Send gibt 202 mit status: accepted zurück, was bedeutet, dass Bird die Nachricht angenommen hat und die Zustellung noch aussteht. Die Skills bringen dem Agent bei, die Nachricht erneut abzurufen, um das endgültige Ergebnis zu lesen, anstatt bei accepted bereits Erfolg zu melden.

email-audit ist ein Spezialist. Er führt bird email tools audit <domain> aus, um die Live-DMARC-, SPF-, DKIM-, BIMI- und MX-Records einer Domain aufzulösen und zu bewerten, und liest dann die nach Schweregrad markierten Ergebnisse als priorisierte Fix-Liste zurück. Er arbeitet nur mit DNS, benötigt also keine Authentifizierung und sendet keine Mails.

Die gemeinsame Voraussetzung: zuerst authentifizieren

Fast jede Operation greift auf die Live-Bird-API zu, daher beginnt bird-cli jede mit einer Anmeldedatenprüfung über bird auth status. Die Prüfung ist idempotent und tut nichts, wenn CLI bereits valid: true meldet, sodass sie jedes Mal gefahrlos vorab ausgeführt werden kann. Ohne sie schlägt eine fehlende Anmeldung genauso fehl wie ein echter API-Fehler und kann den Agent auf den falschen Debugging-Pfad führen.

Die Ausnahmen sind Operationen, die etwas Öffentliches statt Ihres Workspace lesen: email-audit löst DNS auf, und die Dokumentationssuche liest die veröffentlichten Docs. Keine davon benötigt eine Anmeldung, und keine wird durch eine fehlende blockiert.

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

Wenn Anmeldedaten fehlen, leitet der Skill den Agent 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 einer Authentifizierungsaufforderung hängen bleibt.

Fehler treten überall gleich auf

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:

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

Das ist derselbe Vertrag, den die CLI Menschen und Skripten bietet. Die Skills fügen keine Schicht hinzu; sie bringen dem Agent bei, den bestehenden Vertrag zu nutzen. Siehe CLI für Agents für den vollständigen Vertrag, einschließlich Ausgabeformaten und Konfiguration.

Skills zu einer Agent-Schleife zusammensetzen

Da jede Referenz eine selbstprüfende Operation mit maschinenlesbarem Ergebnis ist, lassen sie sich ohne Glue-Code zu einer Schleife zusammensetzen. Zum Beispiel zerlegt sich "send the launch email and confirm it delivered" wie folgt:

1. Authentifizieren: Führen Sie bird auth status aus; melden Sie sich nur bei Bedarf an.
2. Absender finden: Verwenden Sie die Domains-Referenz, um eine from-Adresse auf einer verifizierten Domain auszuwählen. Exit 0 plus eine verifizierte Domain in der JSON bedeutet, dieser Schritt ist abgeschlossen; andernfalls starten Sie die Erstellen-und-Verifizieren-Schleife.
3. Senden: Verwenden Sie die E-Mail-Referenz, um bird email send … auszuführen. Eine erfolgreiche Anfrage gibt 202, eine em_…-ID und status: accepted zurück.
4. Ergebnis bestätigen: Verwenden Sie die E-Mail-Referenz erneut, um bird email get <em_…> auszuführen, bis die Zähler delivered zeigen. Wenn sie bounced zeigen, melden Sie den Fehler.

Die "done when"-Bedingung jedes Schritts ist aus der JSON-Ausgabe des vorherigen Schritts prüfbar, und genau das macht die Schleife zuverlässig: Der Agent muss den Status nie aus Prosa ableiten.

Skills, das Plugin und MCP

Skills sind einer von drei Wegen, einen Agent auf Bird auszurichten, und sie ergänzen sich, statt zu konkurrieren:

• Die bird CLI ist die Ausführungsoberfläche. Skills setzen einen Shell-fähigen Agent voraus, der sie ausführen kann.
• Der MCP-Server ist die Alternative für Agents, die Tools aufrufen statt Befehle auszuführen; die Operationen sind äquivalent, der Transport unterscheidet sich.
• AI Onboarding ist der geführte Setup-Pfad, der beides in wenigen Minuten verbindet.

Ob die Plugin-Installation auch den MCP-Server konfiguriert, hängt vom Client ab. Claude Code erlaubt es einem Plugin, einen Remote-MCP-Server zu deklarieren, sodass die Installation von bird-ai dort https://mcp.bird.com für Sie registriert. OpenCodes Plugin registriert den Server ebenfalls: standardmäßig https://mcp.bird.com/dynamic oder mit OpenCodes experimentellem Code-Modus das vollständige https://mcp.bird.com. Der Cursor Marketplace von Bird und das Antigravity-Plugin enthalten den Server ebenfalls. Das Bird-Plugin in Codex und ChatGPT enthält den MCP-Server und die Skills von Bird. Bei Copilot installiert das Plugin die Skills; bei Droid kopieren Sie die Skill-Dateien manuell hinein. Copilot und Droid erfordern das manuelle Hinzufügen des Servers über die einzeilige Konfiguration im MCP-Server-Leitfaden.

Was kein Plugin tun kann, ist die Authentifizierung für Sie. Der gehostete Server ist OAuth-geschützt, daher melden Sie sich bei jedem Client, einschließlich Claude Code, einmal nach der Server-Registrierung an: Bei Claude Code ist das /mcp, dann wählen Sie bird, dann Authenticate. Bis dahin sind die Tools gelistet, aber jeder Aufruf schlägt fehl. Die clientspezifischen Authentifizierungsschritte decken den Rest ab.

Nächste Schritte

• Coding-Agent einrichten: das Ein-Prompt-Setup, das das Plugin für Sie installiert.
• MCP-Server: die Tool-Oberfläche, die das Plugin mitliefert, und wie Sie sie manuell hinzufügen.
• CLI für Agents: die Befehlsoberfläche, die die Skills vermitteln, für Shell-fähige Agents.
• AI Onboarding: das geführte End-to-End-Setup mit eingebundenem Docs-Korpus.