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. Factory Droid kopiert die Skill-Dateien stattdessen 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:

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/ von Hand 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.

Codebeispiel

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:

Authentifizieren: Führen Sie bird auth status aus; melden Sie sich nur bei Bedarf an.
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.
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.
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 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 von Hand hinein. Jeder Client außer Claude Code benötigt den Server manuell, über die einzeilige Konfiguration im MCP-Server-Guide.

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.

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

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.

Verwandte Ressourcen