Agent-skills

Bird publiceert agent-skills: kant-en-klare procedurebestanden die een coding agent de bird CLI-workflows leren. Een skill beschrijft het happy path van de operatie, de statuscontroles die je eerst moet uitvoeren, en de valkuilen die loopiteraties verspillen. Deze begeleiding helpt de agent het juiste commando te bereiken zonder flags en foutscenario's opnieuw te ontdekken uit --help-output.

Ze worden geleverd als de bird-ai marketplace-plugin, één bron die Claude Code, Cursor, Codex en GitHub Copilot elk als plugin inlezen. Antigravity installeert een pakket dat uit dezelfde bron is gebouwd, en Factory Droid kopieert de skillbestanden handmatig (zie De plugin installeren). Op Claude Code registreert het installeren van de plugin ook de gehoste MCP-server, waarna je je eenmalig aanmeldt met /mcp (zie Skills, de plugin en MCP).

Elke referentie beschrijft één operatie per taak. De agent kiest degene die bij het verzoek past. Afgezien van de gedeelde authenticatievereiste is er geen vaste volgorde.

De plugin installeren

De marketplace staat op messagebird/bird-ai. De plugin volgt Agent Plugins, dus een client die de specificatie implementeert installeert hem vanuit die repository zoals hij is, skills en MCP-server samen.

De clientspecifieke stappen hieronder behandelen de rest. Op Claude Code voer je uit:

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

Voeg in Cursor Bird toe vanuit de Cursor Marketplace of voer /add-plugin bird uit. Je kunt de marketplace ook toevoegen en de bird-plugin installeren via Settings > Plugins. Installeer in ChatGPT en Codex Bird in Codex of ChatGPT. Log in op je Bird-werkruimte en vraag je agent om met Bird te werken. Als terminalalternatief voer je codex plugin marketplace add messagebird/bird-ai uit en daarna codex plugin add bird@bird-ai. Voer in GitHub Copilot copilot plugin marketplace add messagebird/bird-ai uit en daarna copilot plugin install bird@bird-ai. Voer in Antigravity curl -fsSL https://raw.githubusercontent.com/messagebird/bird-ai/main/antigravity.sh | bash uit; dit installeert de plugin in ~/.gemini/config/plugins/bird voor elke werkruimte. De repository-README beschrijft een installatie per project en Antigravity CLI. Factory Droid heeft geen pluginformaat om te lezen: kloon messagebird/bird-ai en kopieer beide skill-directories handmatig van plugins/bird/skills/ naar .factory/skills/.

De skills

Twee skills worden met de plugin meegeleverd.

bird-cli is de algemene skill. Hij routeert een verzoek naar één referentie per CLI-commandogroep, zodat de agent alleen de pagina voor de betreffende operatie laadt en niets anders. De routeringstabel omvat het verzenden en inspecteren van berichten op elk kanaal dat Bird ondersteunt, de setup die elk kanaal nodig heeft voordat het kan verzenden, eenmalige-verificatiecodeverificatie, ontvangersopzoekingen, contacten en doelgroepen, berichtvoorkeuren, Realtime-provisioning, webhooks, API-sleutels, supporttickets en documentatiezoekopdrachten. De eigen SKILL.md van de skill bevat die tabel en is de gezaghebbende lijst: deze pagina kopieert hem bewust niet, omdat een tweede kopie veroudert.

Elke vermelding deelt één gewoonte die het benoemen waard is, omdat agents hier fout gaan: een verzending retourneert 202 met status: accepted, wat betekent dat Bird het bericht heeft aangenomen en de aflevering nog in behandeling is. De skills leren de agent om het bericht opnieuw op te vragen voor het definitieve resultaat in plaats van succes te melden bij accepted.

email-audit is een specialist. Hij voert bird email tools audit <domain> uit om de live DMARC-, SPF-, DKIM-, BIMI- en MX-records van een domein op te lossen en te beoordelen, en leest vervolgens de bevindingen met ernstlabel terug als een geprioriteerde fixlijst. Hij werkt alleen met DNS, heeft dus geen authenticatie nodig en verstuurt geen e-mail.

De gedeelde vereiste: authenticeer eerst

Bijna elke operatie raakt de live Bird API, dus bird-cli begint elke operatie met het bevestigen van credentials via bird auth status. De controle is idempotent en doet niets wanneer de CLI al valid: true rapporteert, dus het is veilig om hem elke keer eerst uit te voeren. Zonder deze controle mislukt een ontbrekende login identiek aan een echte API-fout, waardoor de agent het verkeerde debugpad kan inslaan.

De uitzonderingen zijn operaties die iets publiekelijks lezen in plaats van je werkruimte: email-audit lost DNS op, en documentatiezoeken leest de gepubliceerde docs. Geen van beide vereist een login en geen van beide wordt geblokkeerd door een ontbrekende login.

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

Als credentials ontbreken, leidt de skill de agent via bird auth login terug naar de taak. Authenticatie gebruikt een browser, met een device-code-flow voor headless hosts, zodat de workflow niet vastloopt bij een authenticatieprompt.

Fouten komen overal op dezelfde manier naar boven

Omdat elke operatie een dunne wrapper is over de live API, komen fouten terug via het uniforme contract van de CLI in plaats van via foutafhandeling per skill:

• JSON standaard: Successen printen gestructureerde JSON naar stdout en fouten gaan naar stderr, zodat de loop van de agent uitkomsten kan parsen zonder proza te scrapen.
• Semantische exitcodes: een van zes codes vertelt de agent de foutcategorie voordat hij een melding leest. Zie de volledige tabel in CLI. De agent vertakt op de categorie zonder de melding te parsen: exit 4 betekent de authenticatiestap opnieuw uitvoeren, en exit 3 betekent dat de resource-ID onjuist is, dus opnieuw proberen helpt niet.

Dit is hetzelfde contract dat de CLI aan mensen en scripts biedt. De skills voegen geen laag toe; ze leren de agent het bestaande contract te gebruiken. Zie CLI voor agents voor het volledige contract, inclusief outputformaten en configuratie.

Skills combineren in een agentloop

Omdat elke referentie één zelfcontrolerende operatie is met een machineleesbaar resultaat, combineren ze tot een loop zonder tussenliggende code. Bijvoorbeeld, "send the launch email and confirm it delivered" valt als volgt uiteen:

1. Authenticeren: Voer bird auth status uit; log alleen in als dat nodig is.
2. Een afzender zoeken: Gebruik de domeinreferentie om een from-adres op een geverifieerd domein te kiezen. Exit 0 plus een geverifieerd domein in de JSON betekent dat deze stap voltooid is; ga anders de aanmaak-en-verificatieloop in.
3. Verzenden: Gebruik de e-mailreferentie om bird email send … uit te voeren. Een succesvol verzoek retourneert 202, een em_…-ID en status: accepted.
4. Het resultaat bevestigen: Gebruik de e-mailreferentie opnieuw om bird email get <em_…> uit te voeren totdat de tellingen delivered tonen. Als ze bounced tonen, rapporteer dan de fout.

De "done when"-conditie van elke stap is controleerbaar vanuit de JSON-output van de vorige stap, en dat maakt de loop betrouwbaar: de agent hoeft nooit status af te leiden uit proza.

Skills, de plugin en MCP

Skills zijn een van drie manieren om een agent naar Bird te verwijzen, en ze vullen elkaar aan in plaats van te concurreren:

• De bird CLI is het uitvoeringsoppervlak. Skills gaan uit van een shell-capabele agent die hem kan uitvoeren.
• De MCP-server is het alternatief voor agents die tools aanroepen in plaats van commando's uit te voeren; de operaties zijn equivalent, het transport verschilt.
• AI-onboarding is het begeleide setuppad dat beide in minuten verbindt.

Of de plugininstallatie ook de MCP-server configureert, hangt af van de client. Claude Code laat een plugin een remote MCP-server declareren, dus door bird-ai daar te installeren wordt https://mcp.bird.com voor je geregistreerd. De plugin van OpenCode registreert de server ook: standaard https://mcp.bird.com/dynamic, of de volledige https://mcp.bird.com met de experimentele codemodus van OpenCode aan. De Cursor Marketplace-vermelding van Bird en de Antigravity-plugin bevatten de server eveneens. De Bird-plugin in Codex en ChatGPT bevat de MCP-server en skills van Bird. In Copilot installeert de plugin de skills; in Droid kopieer je de skill-bestanden handmatig. Copilot en Droid vereisen dat je de server handmatig toevoegt, met de éénregelige configuratie in de MCP-servergids.

Wat geen enkele plugin kan doen, is voor je authenticeren. De gehoste server is OAuth-beveiligd, dus op elke client, inclusief Claude Code, meld je je eenmalig aan nadat de server is geregistreerd: in Claude Code is dat /mcp, selecteer dan bird en vervolgens Authenticate. Totdat je dat doet, worden de tools wel vermeld maar mislukt elke aanroep. De authenticatiestappen per client behandelen de rest.

Volgende stappen

• Stel je coding agent in: de one-prompt-setup die de plugin voor je installeert.
• MCP-server: het tooloppervlak dat de plugin bundelt, en hoe je het handmatig toevoegt.
• CLI voor agents: het commando-oppervlak dat de skills aanleren, voor shell-capabele agents.
• AI-onboarding: de begeleide, end-to-end-setup met de docs-corpus gekoppeld.