Agent skills

Bird menerbitkan agent skills: file prosedur terkemas yang mengajarkan coding agent alur kerja bird CLI. Sebuah skill menyediakan jalur sukses operasi, pemeriksaan status yang harus dijalankan lebih dulu, dan jebakan yang membuang iterasi loop. Panduan ini membantu agent 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 menyalin file skill secara manual (lihat Instal plugin). Di Claude Code, menginstal plugin juga mendaftarkan server MCP yang di-host, yang kemudian Anda masuki sekali dengan /mcp (lihat Skills, plugin, dan MCP).

Setiap referensi mengodekan satu operasi per tugas. Agent memilih yang sesuai dengan permintaan. Selain prasyarat autentikasi bersama, tidak ada urutan tertentu.

Instal plugin

Marketplace tersedia di messagebird/bird-ai. Plugin mengikuti spesifikasi Agent Plugins, jadi klien yang mengimplementasikan spesifikasi tersebut menginstalnya dari repositori itu apa adanya, skills 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 yang bisa dibaca: clone messagebird/bird-ai dan salin kedua direktori skill dari plugins/bird/skills/ ke .factory/skills/ secara manual.

Skills

Dua skill disertakan dalam plugin.

bird-cli adalah skill umum. Skill ini merutekan permintaan ke satu referensi per grup perintah CLI, sehingga agent memuat halaman untuk operasi yang sedang dihadapinya dan tidak lebih. Tabel rutingnya mencakup pengiriman dan inspeksi pesan di setiap channel yang didukung Bird, penyiapan yang dibutuhkan tiap channel sebelum bisa mengirim, verifikasi one-time-passcode, pencarian penerima, kontak dan audiens, preferensi pengiriman pesan, provisioning Realtime, webhooks, kunci API, 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 akan kedaluwarsa.

Setiap entri memiliki satu kebiasaan yang perlu disebutkan di sini, karena ini yang sering salah dilakukan agent: operasi kirim mengembalikan 202 dengan status: accepted, yang berarti Bird menerima pesan dan pengiriman masih tertunda. Skill mengajarkan agent untuk membaca kembali pesan demi hasil akhir, bukan menyatakan berhasil saat menerima accepted.

email-audit adalah skill spesialis. Skill ini menjalankan bird email tools audit <domain> untuk meresolusi dan menilai rekaman DMARC, SPF, DKIM, BIMI, dan MX aktif sebuah domain, lalu membaca temuan bertag tingkat keparahan sebagai daftar perbaikan berprioritasi. Skill ini hanya DNS, jadi tidak memerlukan autentikasi dan tidak mengirim email.

Prasyarat bersama: autentikasi lebih dulu

Hampir setiap operasi mengenai Bird API yang aktif, jadi bird-cli memulai setiap operasi dengan mengonfirmasi kredensial melalui bird auth status. Pemeriksaan ini bersifat idempoten dan tidak melakukan apa pun saat CLI sudah melaporkan valid: true, jadi aman untuk dijalankan lebih dulu setiap kali. Tanpanya, login yang hilang gagal dengan cara yang sama persis seperti kesalahan API sungguhan dan bisa mengarahkan agent ke jalur debugging yang salah.

Pengecualiannya adalah operasi yang membaca sesuatu yang publik, bukan workspace Anda: email-audit meresolusi DNS, dan pencarian dokumentasi membaca dokumentasi yang diterbitkan. 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 hilang, skill merutekan agent 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 pun

Karena setiap operasi adalah pembungkus tipis atas API yang aktif, kegagalan dikembalikan melalui kontrak seragam CLI, bukan penanganan kesalahan per skill:

JSON secara default: Keberhasilan mencetak JSON terstruktur ke stdout dan kesalahan masuk ke stderr, sehingga loop agent dapat mem-parse hasil tanpa mengurai prosa.
Kode keluar semantik: satu dari enam kode memberi tahu agent kategori kegagalan sebelum membaca pesan. Lihat tabel lengkapnya di CLI. Agent melakukan percabangan berdasarkan kategori tanpa mem-parse pesan: exit 4 berarti jalankan ulang langkah autentikasi, dan exit 3 berarti ID resource salah, jadi mencoba ulang tidak membantu.

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

Menyusun skills ke dalam loop agent

Karena setiap referensi adalah satu operasi yang memeriksa dirinya sendiri dengan hasil yang dapat dibaca mesin, semuanya dapat disusun menjadi loop tanpa kode perekat. Misalnya, "send the launch email and confirm it delivered" terurai sebagai berikut:

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

Kondisi "done when" setiap langkah dapat diperiksa dari output JSON langkah sebelumnya, dan inilah yang membuat loop dapat diandalkan: agent tidak perlu menyimpulkan status dari prosa.

Skills, plugin, dan MCP

Skills adalah satu dari tiga cara mengarahkan agent ke Bird, dan ketiganya berlapis, bukan bersaing:

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

Apakah pemasangan plugin juga mengonfigurasi server MCP bergantung pada klien. Claude Code memungkinkan plugin mendeklarasikan server MCP jarak jauh, sehingga memasang bird-ai di sana akan mendaftarkan https://mcp.bird.com untuk Anda. Plugin OpenCode juga mendaftarkan server: https://mcp.bird.com/dynamic secara bawaan, atau https://mcp.bird.com lengkap dengan mode kode eksperimental OpenCode aktif. Klien lain mendukung MCP jarak jauh, tetapi plugin mereka tidak bisa mendeklarasikan server terlebih dahulu. Di Cursor, Codex, dan Copilot, plugin memasang skill; di Droid, Anda menyalin file skill secara manual. Klien tersebut memerlukan penambahan server secara manual, menggunakan konfigurasi satu baris di panduan server MCP.

Yang tidak bisa dilakukan plugin mana pun adalah mengautentikasi untuk Anda. Server yang di-host dilindungi OAuth, jadi di setiap klien, termasuk Claude Code, Anda login sekali setelah server terdaftar: di Claude Code caranya /mcp, lalu pilih bird, lalu Authenticate. Sampai Anda melakukannya, tool terdaftar tetapi setiap panggilan gagal. Langkah autentikasi per klien mencakup sisanya.

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

Langkah selanjutnya

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

Sumber daya terkait

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.

Tonton panduannyaSetting up your coding agent Pahami konsepnyaWhat is an MCP server, and how does an agent use one to send messages?Jelajahi kemampuannyaCoding agents Ikuti jalur pembelajaranBuild with AI agents

Dapatkan ringkasan implementasi