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).

Jeder Skill kodiert eine Operation pro Aufgabe. Der Agent wählt denjenigen aus, der zur Anfrage passt. Abgesehen von der gemeinsamen Authentifizierungsvoraussetzung gibt es keine Reihenfolge zwischen den Skills.

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 plugins/bird/skills/bird-cli manuell nach .factory/skills/bird-cli.

Die Operationen

E-Mails senden und prüfen: Eine Nachricht mit bird email send senden und dann die Frage „Ist sie gebounced?" mit bird email get <em_…> oder bird email list --status bounced beantworten. Ein Senden gibt 202 mit status: accepted zurück, was bedeutet, dass Bird die Nachricht angenommen hat und die Zustellung aussteht. Der Skill bringt dem Agenten bei, die Nachricht erneut abzurufen, um das endgültige Ergebnis zu erfahren, anstatt bei accepted den Erfolg zu verkünden.
Sending-Domains verwalten und eine verifizierte from-Adresse finden: Die from-Adresse einer Nachricht muss auf einer verifizierten Sending-Domain liegen. Vor einem Senden lässt der Skill den Agenten einen verwendbaren Absender mit bird email domains list finden oder die Einrichtungsschleife durchlaufen: bird email domains create → die zurückgegebenen DNS-Einträge hinzufügen → bird email domains verify → wiederholen bis verified. Die DNS-Propagierung ist asynchron, daher liest eine Verifizierung unmittelbar nach dem Erstellen normalerweise noch pending.
Ausgehende Webhook-Endpunkte verwalten: Die Endpunkte registrieren, auflisten, prüfen, testen und löschen, an die Bird Events ausliefert. Der Skill weist den Agenten an, das nur bei der Erstellung verfügbare Signing-Secret aus der Create-Antwort zu erfassen, da es nie wieder zurückgegeben wird. Er warnt auch, dass bird webhooks test eine echte Zustellung an die Live-URL durchführt.

Die gemeinsame Voraussetzung: Zuerst authentifizieren

Jede Operation trifft die Live-Bird-API, daher beginnt jeder Skill 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.

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 jeder Skill 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: Den Domains-Skill 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: Den E-Mail-Skill verwenden, um bird email send … auszuführen. Eine erfolgreiche Anfrage gibt 202, eine em_…-ID und status: accepted zurück.
Ergebnis bestätigen: Den E-Mail-Skill 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.