Agent-Skills

Bird veröffentlicht Agent-Skills: paketierte Prozedurdateien, die ein Coding-Agent lädt und die ihm die bird-CLI-Workflows beibringen. Anstatt dass der Agent Flags und Fehlermodi aus der --help-Ausgabe neu entdecken muss, liefert ihm ein Skill den Happy Path der Operation, die vorab auszuführenden Zustandsprüfungen und die Fallstricke, die Schleifeniterationen verschwenden — so gelangt der Agent beim ersten Versuch zum korrekten Befehl, nicht erst beim fünften.

Sie werden als bird-ai-Marketplace-Plugin ausgeliefert, das die Skills in Claude Code, Cursor, Codex, GitHub Copilot und Factory Droid aus einer einzigen Quelle installiert: Jeder Client liest die Skills des Plugins nativ. 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 unten).

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

Plugin installieren

Der Marketplace befindet sich unter messagebird/bird-ai. Bei Claude Code, Copilot und Droid — die das Plugin-Manifest im Claude-Format direkt lesen:

Codebeispiel

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

Bei Cursor fügen Sie den Marketplace hinzu und installieren das bird-Plugin über Settings → Plugins (oder /add-plugin bird). Bei Codex führen Sie codex plugin marketplace add messagebird/bird-ai aus, dann /plugins innerhalb von codex und installieren das bird-Plugin. Die Skills werden in jedem Fall nativ installiert.

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. Der Skill kodiert die entscheidende Unterscheidung: Ein Senden gibt 202 mit status: accepted zurück, was bedeutet, dass Bird die Nachricht angenommen hat — nicht, dass sie zugestellt wurde. Die Zustellung ist asynchron, daher bringt der Skill dem Agenten bei, die Nachricht erneut abzurufen, um das tatsächliche 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, daher lässt der Skill den Agenten vor jedem Senden einen verwendbaren Absender finden (bird email domains list, gefiltert nach einer verifizierten Sendefähigkeit) oder die Einrichtungsschleife durchlaufen: bird email domains create → die zurückgegebenen DNS-Einträge hinzufügen → bird email domains verify → wiederholen bis verified. Er kodiert auch den Fallstrick, dass die DNS-Propagierung asynchron ist — eine sofortige Verifizierung nach dem Erstellen liest fast immer noch pending.
Ausgehende Webhook-Endpunkte verwalten — die Endpunkte registrieren, auflisten, prüfen, testen und löschen, an die Bird Events ausliefert. Der Skill kodiert das nur bei der Erstellung verfügbare Signing-Secret (aus der Create-Antwort erfassen; es wird nie wieder zurückgegeben), und 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 auf die gleiche Weise: Anmeldedaten mit bird auth status bestätigen, bevor irgendetwas anderes getan wird. Die Prüfung ist idempotent — ein No-Op, wenn die CLI bereits valid: true meldet — daher ist es sicher (und empfohlen), sie jedes Mal zuerst auszuführen. Ohne sie schlägt ein fehlender Login identisch wie ein echter API-Fehler fehl, und der Agent verschwendet Iterationen mit der Fehlersuche am falschen Problem.

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 (browserbasiert, mit einem Device-Code-Flow für Headless-Hosts) und zurück zur Aufgabe — er bleibt nie bei „Bitte authentifizieren" stehen.

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, Fehler gehen auf stderr, sodass die Schleife des Agenten Ergebnisse parsen kann, ohne Prosa zu durchsuchen.
Semantische Exit-Codes — 2 ungültige Nutzung oder Eingabe, 3 nicht gefunden, 4 Authentifizierung oder Berechtigung verweigert, 1 alles andere. Der Agent verzweigt anhand der Kategorie, ohne die Nachricht zu parsen: Exit 4 bedeutet, den Authentifizierungsschritt erneut auszuführen; Exit 3 bedeutet, die Ressourcen-ID ist falsch, und ein erneuter Versuch hilft nicht.

Dies ist derselbe Vertrag, den die CLI Menschen und Skripten präsentiert — die Skills fügen keine Schicht darüber hinzu, sie bringen dem Agenten lediglich bei, ihn zu nutzen. Der vollständige Vertrag, einschließlich Ausgabeformate und Konfiguration, befindet sich auf der Seite CLI für Agenten.

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. Eine realistische Aufgabe — „Sende die Launch-E-Mail und bestätige die Zustellung" — zerlegt sich wie folgt:

Authentifizieren — bird auth status; nur bei Bedarf anmelden.
Absender finden — Domains-Skill: eine from-Adresse auf einer verifizierten Domain auswählen (Exit 0 + eine verifizierte Domain im JSON, oder in die Erstellen-und-Verifizieren-Schleife eintreten).
Senden — E-Mail-Skill: bird email send …; Erfolg ist 202 mit einer em_…-ID und status: accepted.
Ergebnis bestätigen — erneut E-Mail-Skill: bird email get <em_…> bis die Zähler delivered anzeigen (oder bounced, in welchem Fall der Agent den Fehler meldet, anstatt zu raten).

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. Die anderen Clients unterstützen Remote-MCP, erlauben einem Plugin aber nicht, es vorab zu deklarieren, daher liefert das Plugin bei Cursor, Codex, Copilot und Droid die Skills und Sie fügen den MCP-Server einmalig manuell hinzu; die einzeilige Konfiguration befindet sich auf der Seite MCP-Server.

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