Skill agen

Bird menerbitkan skill agen: file prosedur terkemas yang mengajarkan agen coding alur kerja bird CLI. Sebuah skill memberikan jalur sukses operasi, pemeriksaan state yang harus dijalankan terlebih dahulu, dan jebakan yang membuang iterasi loop. Panduan ini membantu agen mencapai perintah yang benar tanpa harus menemukan ulang flag dan mode kegagalan dari output --help.

Skill ini dikirimkan sebagai plugin marketplace bird-ai, satu sumber yang dibaca oleh Claude Code, Cursor, Codex, dan GitHub Copilot sebagai plugin. Factory Droid sebagai gantinya menyalin file skill secara manual (lihat Menginstal plugin). Di Claude Code, menginstal plugin juga mendaftarkan server MCP ter-hosting, yang kemudian Anda masuki sekali dengan /mcp (lihat Skill, plugin, dan MCP).

Setiap referensi mengodekan satu operasi per tugas. Agen memilih yang sesuai dengan permintaan. Selain prasyarat autentikasi bersama, mereka tidak memiliki urutan.

Menginstal plugin

Marketplace berada di messagebird/bird-ai. Plugin mengikuti Agent Plugins, jadi klien yang mengimplementasikan spesifikasi tersebut menginstalnya dari repositori itu apa adanya, skill dan server MCP sekaligus.

Langkah per klien di bawah mencakup sisanya. Di Claude Code, jalankan:

Contoh kode

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

Di Cursor, tambahkan marketplace dan instal plugin bird dari Settings > Plugins. Di Codex, jalankan codex plugin marketplace add messagebird/bird-ai, lalu codex plugin add bird@bird-ai. Di GitHub Copilot, jalankan copilot plugin marketplace add messagebird/bird-ai, lalu copilot plugin install bird@bird-ai. Factory Droid tidak memiliki format plugin untuk dibaca: clone messagebird/bird-ai dan salin kedua direktori skill dari plugins/bird/skills/ ke .factory/skills/ secara manual.

Skill-skill

Dua skill dikirimkan dalam plugin.

bird-cli adalah yang umum. Skill ini merutekan permintaan ke satu referensi per grup perintah CLI, sehingga agen memuat halaman untuk operasi yang ada di depannya dan tidak yang lain. Tabel rutingnya mencakup pengiriman dan pemeriksaan pesan di setiap channel yang dijalankan Bird, setup yang dibutuhkan setiap channel sebelum dapat mengirim, verifikasi one-time-passcode, pencarian penerima, kontak dan audiens, preferensi pesan, provisioning Realtime, webhook, API key, tiket dukungan, dan pencarian dokumentasi. SKILL.md milik skill itu sendiri memuat tabel tersebut, dan itu adalah daftar otoritatif: halaman ini sengaja tidak menyalinnya, karena salinan kedua adalah salinan yang menjadi basi.

Setiap entri berbagi satu kebiasaan yang layak disebutkan di sini, karena ini adalah yang sering salah dilakukan agen: pengiriman mengembalikan 202 dengan status: accepted, yang berarti Bird menerima pesan dan pengiriman masih berlangsung. Skill mengajarkan agen untuk membaca kembali pesan untuk hasil akhir alih-alih menyatakan berhasil pada accepted.

email-audit adalah spesialis. Skill ini menjalankan bird email tools audit <domain> untuk me-resolve dan menilai record DMARC, SPF, DKIM, BIMI, dan MX live sebuah domain, lalu membaca temuan yang diberi tag tingkat keparahan sebagai daftar perbaikan yang diprioritaskan. Skill ini hanya DNS, jadi tidak memerlukan autentikasi dan tidak mengirim email.

Prasyarat bersama: autentikasi terlebih dahulu

Hampir setiap operasi mengakses API Bird live, jadi bird-cli memulai setiap operasi dengan mengonfirmasi kredensial menggunakan bird auth status. Pemeriksaan ini idempoten dan tidak melakukan apa-apa ketika CLI sudah melaporkan valid: true, jadi aman untuk dijalankan terlebih dahulu setiap kali. Tanpanya, login yang hilang gagal secara identik dengan error API nyata dan dapat mengarahkan agen ke jalur debugging yang salah.

Pengecualiannya adalah operasi yang membaca sesuatu yang publik alih-alih workspace Anda: email-audit me-resolve DNS, dan pencarian dokumentasi membaca dokumen yang dipublikasikan. Keduanya tidak memerlukan login, dan keduanya tidak diblokir oleh login yang hilang.

Contoh kode

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

Jika kredensial tidak ada, skill mengarahkan agen melalui bird auth login dan kembali ke tugas. Autentikasi menggunakan browser, dengan alur device-code untuk host tanpa tampilan, sehingga alur kerja tidak macet di prompt autentikasi.

Kegagalan muncul dengan cara yang sama di mana-mana

Karena setiap operasi adalah wrapper tipis di atas API live, kegagalan dikembalikan melalui kontrak seragam CLI, bukan penanganan error per-skill:

JSON secara default: Keberhasilan mencetak JSON terstruktur ke stdout dan error dikirim ke stderr, sehingga loop agen dapat mem-parse hasil tanpa mengurai teks prosa.
Exit code semantik: satu dari enam kode memberitahu agen kategori kegagalan sebelum membaca pesan. Lihat tabel lengkap di CLI. Agen bercabang berdasarkan kategori tanpa mem-parse pesan: exit 4 berarti jalankan ulang langkah autentikasi, dan exit 3 berarti ID resource salah, jadi mencoba ulang tidak akan membantu.

Ini adalah kontrak yang sama yang disajikan CLI kepada manusia dan skrip. Skill tidak menambahkan lapisan; mereka mengajarkan agen untuk menggunakan kontrak yang ada. Lihat CLI for agents untuk kontrak lengkap, termasuk format output dan konfigurasi.

Menyusun skill menjadi loop agen

Karena setiap referensi adalah satu operasi yang memeriksa diri sendiri dengan hasil yang dapat dibaca mesin, mereka dapat disusun menjadi loop tanpa kode perekat. Sebagai contoh, "kirim email peluncuran dan konfirmasi terkirim" didekomposisi sebagai berikut:

Autentikasi: Jalankan bird auth status; login hanya jika diperlukan.
Temukan pengirim: Gunakan referensi domain untuk memilih alamat from di domain terverifikasi. Exit 0 ditambah domain terverifikasi di JSON berarti langkah ini selesai; jika tidak, masuk ke loop create-and-verify.
Kirim: Gunakan referensi email untuk menjalankan bird email send …. Permintaan yang berhasil mengembalikan 202, ID em_…, dan status: accepted.
Konfirmasi hasilnya: Gunakan referensi email lagi untuk menjalankan bird email get <em_…> hingga hitungan menunjukkan delivered. Jika menunjukkan bounced, laporkan kegagalannya.

Kondisi "selesai ketika" setiap langkah dapat diperiksa dari output JSON langkah sebelumnya, yang membuat loop ini andal: agen tidak perlu menyimpulkan state dari teks prosa.

Skill, plugin, dan MCP

Skill adalah salah satu dari tiga cara untuk mengarahkan agen ke Bird, dan mereka berlapis bukan bersaing:

bird CLI adalah permukaan eksekusi. Skill mengasumsikan agen yang mampu shell dan dapat menjalankannya.
Server MCP adalah alternatif untuk agen yang memanggil tool alih-alih menjalankan perintah; operasinya setara, transportnya berbeda.
AI onboarding adalah jalur setup terpandu yang menghubungkan keduanya dalam hitungan menit.

Apakah instalasi plugin juga mengonfigurasi server MCP tergantung pada kliennya. Claude Code memungkinkan plugin mendeklarasikan server MCP remote, jadi menginstal bird-ai di sana mendaftarkan https://mcp.bird.com untuk Anda. Klien lain mendukung MCP remote, tetapi plugin mereka tidak dapat mendeklarasikan server sebelumnya. Di Cursor, Codex, dan Copilot, plugin menginstal skill; di Droid, Anda menyalin file skill secara manual. Setiap klien selain Claude Code memerlukan server ditambahkan secara manual, menggunakan konfigurasi satu baris di panduan MCP server.

Yang tidak bisa dilakukan plugin adalah mengautentikasi untuk Anda. Server ter-hosting dilindungi OAuth, jadi di setiap klien, termasuk Claude Code, Anda masuk sekali setelah server terdaftar: di Claude Code itu adalah /mcp, lalu pilih bird, lalu Authenticate. Sampai Anda melakukannya, tool terdaftar dan setiap panggilan gagal. Langkah autentikasi per klien mencakup sisanya.

Klien	Skill via plugin	Server MCP terdaftar	Masuk
Claude Code	Ya	Ya, dideklarasikan oleh plugin	Anda: /mcp > bird > Authenticate
Cursor	Ya	Manual, tambahkan server remote sekali	Anda: Needs login di Tools & Integrations
Codex	Ya	Manual, tambahkan server remote sekali	Anda: codex mcp login bird
GitHub Copilot	Ya	Manual, tambahkan server remote sekali	VS Code membuka browser saat pertama kali dijalankan
Factory Droid	Manual, salin file skill secara manual	Manual, tambahkan server remote sekali	Anda: /mcp di dalam droid

Langkah selanjutnya

Siapkan agen coding Anda: setup satu prompt yang menginstal plugin untuk Anda.
Server MCP: permukaan tool yang dibundel plugin, dan cara menambahkannya secara manual.
CLI for agents: permukaan perintah yang diajarkan skill, untuk agen yang mampu shell.
AI onboarding: setup terpandu end-to-end dengan korpus dokumentasi yang terhubung.