Agent-vaardigheden

Bird publiceert agent-vaardigheden: verpakte procedurebestanden die een codeeragent de bird CLI-workflows leren. Een vaardigheid biedt het happy path van de operatie, de statuscontroles die eerst uitgevoerd moeten worden, en de valkuilen die lusiteraties verspillen. Deze begeleiding helpt de agent een correct commando te bereiken zonder vlaggen en foutmodi opnieuw te moeten ontdekken via --help-uitvoer.

Ze worden geleverd als de bird-ai marketplace-plugin, één bron die Claude Code, Cursor, Codex en GitHub Copilot elk als plugin lezen. Factory Droid kopieert in plaats daarvan de vaardigheidsbestanden handmatig (zie De plugin installeren). Op Claude Code registreert het installeren van de plugin ook de gehoste MCP-server, waarna je eenmalig inlogt met /mcp (zie Vaardigheden, de plugin en MCP).

Elke referentie codeert één operatie per taak. De agent kiest degene die bij het verzoek past. Afgezien van de gedeelde authenticatievereiste hebben ze geen volgorde.

De plugin installeren

De marketplace is te vinden op messagebird/bird-ai. De plugin volgt Agent Plugins, dus een client die de specificatie implementeert installeert het vanuit die repository zoals het is, vaardigheden en MCP-server samen.

De per-client stappen hieronder dekken de rest. Op Claude Code, voer 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, dan codex plugin add bird@bird-ai. Op GitHub Copilot voer je copilot plugin marketplace add messagebird/bird-ai uit, dan copilot plugin install bird@bird-ai. Factory Droid heeft geen pluginformaat om te lezen: kloon messagebird/bird-ai en kopieer beide vaardigheidsmappen uit plugins/bird/skills/ handmatig naar .factory/skills/.

De vaardigheden

Er worden twee vaardigheden meegeleverd in de plugin.

bird-cli is de algemene. Het routeert een verzoek naar één referentie per CLI-commandogroep, zodat de agent de pagina voor de betreffende operatie laadt en niets anders. De routeringstabel omvat het verzenden en inspecteren van berichten op elk kanaal dat Bird bedient, de setup die elk kanaal nodig heeft voordat het kan verzenden, eenmalig-wachtwoord-verificatie, ontvanger-opzoeken, contacten en doelgroepen, berichtvoorkeuren, Realtime-provisioning, webhooks, API-sleutels, supporttickets en documentatie-zoeken. De eigen SKILL.md van de vaardigheid bevat die tabel, en het is de gezaghebbende lijst: deze pagina kopieert die bewust niet, omdat een tweede kopie een kopie is die veroudert.

Elke vermelding deelt één gewoonte die het hier benoemen waard is, omdat het de gewoonte is die agents fout doen: een verzending retourneert 202 met status: accepted, wat betekent dat Bird het bericht heeft aangenomen en aflevering nog in behandeling is. De vaardigheden leren de agent het bericht terug te lezen voor het uiteindelijke resultaat in plaats van bij accepted succes te declareren.

email-audit is een specialist. Het 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 ernst-tags terug als een geprioriteerde fixlijst. Het is alleen DNS, dus het heeft geen authenticatie nodig en verzendt geen e-mail.

De gedeelde vereiste: eerst authenticeren

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

De uitzonderingen zijn de operaties die iets publiekelijks lezen in plaats van je workspace: email-audit resolvet DNS, en documentatie-zoeken leest de gepubliceerde docs. Geen van beide heeft een login nodig, 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 inloggegevens ontbreken, stuurt de vaardigheid de agent door bird auth login en terug naar de taak. Authenticatie gebruikt een browser, met een device-code-flow voor headless hosts, dus de workflow blijft niet hangen 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 per-vaardigheid foutafhandeling:

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

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

Vaardigheden samenstellen in een agentlus

Omdat elke referentie één zelfcontrolerende operatie is met een machineleesbaar resultaat, zijn ze samen te stellen tot een lus zonder lijmcode. Bijvoorbeeld, "verstuur de launch-e-mail en bevestig dat deze is afgeleverd" ontleedt als volgt:

Authenticeren: Voer bird auth status uit; alleen inloggen indien nodig.
Een afzender vinden: 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; anders, ga de aanmaak-en-verificatielus 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 opnieuw de e-mailreferentie om bird email get <em_…> uit te voeren tot de tellingen delivered tonen. Als ze bounced tonen, rapporteer de fout.

De "klaar wanneer"-conditie van elke stap is controleerbaar vanuit de JSON-uitvoer van de vorige stap, en dat is wat de lus betrouwbaar maakt: de agent hoeft nooit status af te leiden uit proza.

Vaardigheden, de plugin en MCP

Vaardigheden zijn één van drie manieren om een agent op Bird te richten, en ze stapelen in plaats van concurreren:

De bird CLI is het uitvoeringsoppervlak. Vaardigheden gaan uit van een shell-capabele agent die het kan draaien.
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 enkele 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 het installeren van bird-ai registreert daar https://mcp.bird.com voor je. Andere clients ondersteunen remote MCP, maar hun plugins kunnen geen server vooraf declareren. Op Cursor, Codex en Copilot installeert de plugin de vaardigheden; op Droid kopieer je de vaardigheidsbestanden handmatig. Elke client behalve Claude Code heeft de server handmatig nodig, via de eenregelige 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, log je eenmalig in nadat de server is geregistreerd: in Claude Code is dat /mcp, selecteer dan bird, dan Authenticate. Tot je dat doet, worden de tools weergegeven maar faalt elke aanroep. De per-client authenticatiestappen dekken de rest.

Client	Vaardigheden via plugin	MCP-server geregistreerd	Inloggen
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 eerste start
Factory Droid	Handmatig, kopieer de vaardigheidsbestanden	Handmatig, voeg de remote server eenmalig toe	Jij: /mcp in droid

Volgende stappen

Je codeeragent instellen: 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 commandooppervlak dat de vaardigheden leren, voor shell-capabele agents.
AI-onboarding: het begeleide, end-to-end setuppad met het docs-corpus aangesloten.