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. Factory Droid kopieert de skillbestanden in plaats daarvan 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 client-specifieke stappen hieronder behandelen de rest. Op Claude Code voer je uit:

Codevoorbeeld

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

Op Cursor voeg je de marketplace toe en installeer je de bird-plugin via Settings > Plugins. Op Codex voer je codex plugin marketplace add messagebird/bird-ai uit en daarna codex plugin add bird@bird-ai. Op GitHub Copilot voer je copilot plugin marketplace add messagebird/bird-ai uit en daarna copilot plugin install bird@bird-ai. Factory Droid heeft geen pluginformaat om in te lezen: kloon messagebird/bird-ai en kopieer beide skilldirectory's 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.

Codevoorbeeld

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:

Authenticeren: Voer bird auth status uit; log alleen in als dat nodig is.
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.
Verzenden: Gebruik de e-mailreferentie om bird email send … uit te voeren. Een succesvol verzoek retourneert 202, een em_…-ID en status: accepted.
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 plugin-installatie ook de MCP-server configureert, hangt af van de client. Claude Code laat een plugin een remote MCP-server declareren, dus als je bird-ai daar installeert, wordt https://mcp.bird.com automatisch 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. Andere clients ondersteunen remote MCP, maar hun plugins kunnen geen server vooraf declareren. Op Cursor, Codex en Copilot installeert de plugin de skills; op Droid kopieer je de skillbestanden handmatig. Die clients hebben de server handmatig nodig, via 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.

Client	Skills via plugin	MCP-server geregistreerd	Aanmelding
Claude Code	Ja	Ja, gedeclareerd door de plugin	Jij: /mcp > bird > Authenticate
Cursor	Ja	Handmatig, voeg de remote server eenmalig toe	Jij: Needs login in Tools & Integrations
Codex	Ja	Handmatig, voeg de remote server eenmalig toe	Jij: codex mcp login bird
GitHub Copilot	Ja	Handmatig, voeg de remote server eenmalig toe	VS Code opent de browser bij de eerste start
Factory Droid	Handmatig, kopieer de skillbestanden	Handmatig, voeg de remote server eenmalig toe	Jij: /mcp binnen droid
OpenCode	Ja	Ja, gedeclareerd door de plugin	Jij: opencode mcp auth bird

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öppervlak dat de skills aanleren, voor shell-capabele agents.
AI-onboarding: de begeleide, end-to-end-setup met de docs-corpus gekoppeld.

Gerelateerde bronnen

Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.

Bekijk de gidsSetting up your coding agent Begrijp het conceptWhat is an MCP server, and how does an agent use one to send messages?Ontdek de mogelijkheidCoding agents Volg het leerpadBuild with AI agents

Ontvang een implementatieoverzicht