एजेंट स्किल्स

Bird एजेंट स्किल्स प्रकाशित करता है: ये पैकेज की गई प्रक्रिया फ़ाइलें हैं, जो कोडिंग एजेंट को bird CLI वर्कफ़्लो सिखाती हैं। हर स्किल ऑपरेशन का सामान्य सफल रास्ता देती है, पहले चलाने वाली स्थिति जाँचें बताती है और उन गलतियों से आगाह करती है जिनसे लूप के चक्र बेकार जाते हैं। इस मार्गदर्शन से एजेंट सही कमांड तक पहुँचता है, और उसे --help आउटपुट से फ़्लैग और विफलता के कारण दोबारा नहीं खोजने पड़ते।

ये bird-ai मार्केटप्लेस प्लगइन के रूप में आती हैं। यह एक ही स्रोत है, जिसे Claude Code, Cursor, Codex और GitHub Copilot में से हर एक प्लगइन के रूप में पढ़ता है। Antigravity इसी स्रोत से बना पैकेज इंस्टॉल करता है, और Factory Droid में स्किल फ़ाइलें हाथ से कॉपी की जाती हैं (देखें प्लगइन इंस्टॉल करें)। Claude Code पर प्लगइन इंस्टॉल करने से होस्ट किया गया MCP सर्वर भी रजिस्टर हो जाता है, जिसमें आप फिर /mcp से एक बार साइन इन करते हैं (देखें स्किल्स, प्लगइन और MCP)।

हर संदर्भ हर कार्य के लिए एक ऑपरेशन तय करता है। एजेंट वही संदर्भ चुनता है जो अनुरोध से मेल खाता है। साझा प्रमाणीकरण शर्त को छोड़कर इनका कोई तय क्रम नहीं है।

प्लगइन इंस्टॉल करें

मार्केटप्लेस messagebird/bird-ai पर है। प्लगइन Agent Plugins का पालन करता है, इसलिए जो क्लाइंट इस विनिर्देश को लागू करता है, वह इसे उसी रिपॉज़िटरी से बिना बदलाव के इंस्टॉल कर लेता है, स्किल्स और MCP सर्वर दोनों एक साथ।

बाकी काम नीचे दिए गए क्लाइंट-वार चरणों में है। Claude Code पर यह चलाएँ:

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

Cursor पर, Cursor Marketplace से Bird जोड़ें या /add-plugin bird चलाएँ। आप Settings > Plugins से मार्केटप्लेस जोड़कर bird प्लगइन भी इंस्टॉल कर सकते हैं। ChatGPT और Codex पर, Codex या ChatGPT में Bird इंस्टॉल करें। अपने Bird वर्कस्पेस में साइन इन करें, फिर अपने एजेंट से Bird के साथ काम करने को कहें। टर्मिनल से करने के लिए codex plugin marketplace add messagebird/bird-ai चलाएँ, फिर codex plugin add bird@bird-ai। GitHub Copilot पर copilot plugin marketplace add messagebird/bird-ai चलाएँ, फिर copilot plugin install bird@bird-ai। Antigravity पर curl -fsSL https://raw.githubusercontent.com/messagebird/bird-ai/main/antigravity.sh | bash चलाएँ, जो प्लगइन को हर वर्कस्पेस के लिए ~/.gemini/config/plugins/bird में इंस्टॉल करता है। प्रति-प्रोजेक्ट इंस्टॉल और Antigravity CLI की जानकारी रिपॉज़िटरी README में है। Factory Droid में पढ़ने के लिए कोई प्लगइन फ़ॉर्मेट नहीं है: messagebird/bird-ai को क्लोन करें और दोनों स्किल डायरेक्टरी plugins/bird/skills/ से .factory/skills/ में हाथ से कॉपी करें।

स्किल्स

प्लगइन में दो स्किल्स आती हैं।

bird-cli सामान्य स्किल है। यह हर अनुरोध को हर CLI कमांड समूह के एक रेफ़रेंस तक भेजती है, ताकि एजेंट केवल सामने वाले ऑपरेशन का पेज लोड करे और कुछ नहीं। इसकी रूटिंग तालिका में ये सब शामिल हैं: Bird के हर चैनल पर संदेश भेजना और उनकी जाँच करना, भेजने से पहले हर चैनल का ज़रूरी सेटअप, वन-टाइम-पासकोड सत्यापन, प्राप्तकर्ता लुकअप, संपर्क और ऑडियंस, मैसेजिंग प्राथमिकताएँ, Realtime प्रोविज़निंग, वेबहुक, API कुंजियाँ, सपोर्ट टिकट और दस्तावेज़ खोज। यह तालिका स्किल की अपनी SKILL.md में है, और वही आधिकारिक सूची है। यह पेज उसकी नकल नहीं करता, क्योंकि दूसरी प्रति समय के साथ पुरानी पड़ जाती है।

हर एंट्री में एक आदत साझा है, और एजेंट अक्सर इसी में गलती करते हैं: भेजने पर 202 के साथ status: accepted लौटता है, जिसका अर्थ है कि Bird ने संदेश स्वीकार कर लिया है और डिलीवरी अभी बाकी है। स्किल एजेंट को सिखाती हैं कि वह accepted पर ही सफलता घोषित न करे, बल्कि अंतिम परिणाम के लिए संदेश को दोबारा पढ़े।

email-audit एक विशेष स्किल है। यह किसी डोमेन के लाइव DMARC, SPF, DKIM, BIMI और MX रिकॉर्ड को रिज़ॉल्व करने और उनका मूल्यांकन करने के लिए bird email tools audit <domain> चलाती है। फिर यह गंभीरता-टैग वाले निष्कर्षों को प्राथमिकता के क्रम में सुधारों की सूची के रूप में लौटाती है। यह केवल DNS पढ़ती है, इसलिए इसे ऑथेंटिकेशन की ज़रूरत नहीं होती और यह कोई मेल नहीं भेजती।

साझा पूर्व-शर्त: पहले ऑथेंटिकेट करें

लगभग हर ऑपरेशन लाइव Bird API को कॉल करता है, इसलिए bird-cli हर ऑपरेशन की शुरुआत bird auth status से क्रेडेंशियल की पुष्टि करके करती है। यह जाँच idempotent है और जब CLI पहले से valid: true दिखाता है, तब कुछ नहीं करती, इसलिए इसे हर बार पहले चलाना सुरक्षित है। इसके बिना, लॉगिन न होने पर वैसी ही विफलता दिखती है जैसी असली API त्रुटि पर, और एजेंट गलत दिशा में डिबगिंग कर सकता है।

अपवाद वे ऑपरेशन हैं जो आपके वर्कस्पेस के बजाय कुछ सार्वजनिक पढ़ते हैं: email-audit DNS रिज़ॉल्व करता है, और दस्तावेज़ खोज प्रकाशित दस्तावेज़ पढ़ती है। इनमें से किसी को लॉगिन की ज़रूरत नहीं है, और लॉगिन न होने से कोई भी रुकता नहीं।

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

अगर क्रेडेंशियल नहीं हैं, तो स्किल एजेंट को bird auth login से गुज़ारकर वापस काम पर ले आती है। ऑथेंटिकेशन ब्राउज़र से होता है, और बिना डिस्प्ले वाले होस्ट के लिए डिवाइस-कोड फ़्लो उपलब्ध है, इसलिए वर्कफ़्लो ऑथेंटिकेशन प्रॉम्प्ट पर अटकता नहीं।

विफलताएँ हर जगह एक ही तरह सामने आती हैं

हर ऑपरेशन लाइव API के ऊपर एक पतला रैपर है, इसलिए विफलताएँ हर स्किल की अलग त्रुटि-हैंडलिंग के बजाय CLI के एकसमान अनुबंध से लौटती हैं:

• डिफ़ॉल्ट रूप से JSON: सफल परिणाम stdout पर संरचित JSON के रूप में छपते हैं और त्रुटियाँ stderr पर जाती हैं, ताकि एजेंट का लूप टेक्स्ट खंगाले बिना परिणाम पार्स कर सके।
• अर्थपूर्ण एग्ज़िट कोड: छह में से एक कोड संदेश पढ़ने से पहले ही एजेंट को विफलता की श्रेणी बता देता है। पूरी तालिका CLI में देखें। एजेंट संदेश पार्स किए बिना श्रेणी के आधार पर आगे का रास्ता चुनता है: एग्ज़िट 4 का अर्थ है ऑथेंटिकेशन चरण दोबारा चलाएँ, और एग्ज़िट 3 का अर्थ है कि रिसोर्स ID गलत है, इसलिए फिर से प्रयास करने से कोई फ़ायदा नहीं।

यही अनुबंध CLI इंसानों और स्क्रिप्ट के लिए भी देता है। स्किल कोई नई परत नहीं जोड़तीं; वे एजेंट को मौजूदा अनुबंध का उपयोग करना सिखाती हैं। आउटपुट फ़ॉर्मैट और कॉन्फ़िगरेशन सहित पूरे अनुबंध के लिए एजेंटों के लिए CLI देखें।

स्किल को एजेंट लूप में जोड़ना

हर रेफ़रेंस एक स्व-जाँच करने वाला ऑपरेशन है जिसका परिणाम मशीन पढ़ सकती है, इसलिए ये बिना ग्लू कोड के एक लूप में जुड़ जाते हैं। उदाहरण के लिए, "send the launch email and confirm it delivered" इन चरणों में बँटता है:

1. प्रमाणीकरण करें: bird auth status चलाएँ; ज़रूरत हो तभी लॉग इन करें।
2. भेजने वाला खोजें: सत्यापित डोमेन पर from पता चुनने के लिए domains रेफ़रेंस का उपयोग करें। अगर exit 0 मिले और JSON में सत्यापित डोमेन हो, तो यह चरण पूरा है; नहीं तो बनाने और सत्यापित करने वाले लूप में जाएँ।
3. भेजें: bird email send … चलाने के लिए email रेफ़रेंस का उपयोग करें। सफल अनुरोध 202, एक em_… ID और status: accepted लौटाता है।
4. परिणाम की पुष्टि करें: email रेफ़रेंस से फिर bird email get <em_…> तब तक चलाएँ जब तक गिनती में delivered न दिखे। अगर उसमें bounced दिखे, तो विफलता की रिपोर्ट करें।

हर चरण की "done when" शर्त पिछले चरण के JSON आउटपुट से जाँची जा सकती है, और इसी से लूप भरोसेमंद बनता है: एजेंट को कभी गद्य पढ़कर स्थिति का अनुमान नहीं लगाना पड़ता।

स्किल, प्लगइन और MCP

किसी एजेंट को Bird से जोड़ने के तीन तरीके हैं और स्किल उनमें से एक है। ये तरीके एक-दूसरे के विकल्प नहीं, बल्कि एक-दूसरे के ऊपर काम करते हैं:

• bird CLI वह जगह है जहाँ कमांड चलते हैं। स्किल मानकर चलती हैं कि एजेंट शेल चला सकता है और इसे चला सकता है।
• MCP सर्वर उन एजेंटों के लिए विकल्प है जो कमांड चलाने के बजाय टूल कॉल करते हैं; ऑपरेशन वही हैं, केवल ट्रांसपोर्ट अलग है।
• AI ऑनबोर्डिंग निर्देशित सेटअप है जो इनमें से किसी को भी कुछ ही मिनटों में जोड़ देता है।

प्लगइन इंस्टॉल करने पर MCP सर्वर भी कॉन्फ़िगर होता है या नहीं, यह क्लाइंट पर निर्भर करता है। Claude Code में प्लगइन रिमोट MCP सर्वर घोषित कर सकता है, इसलिए वहाँ bird-ai इंस्टॉल करने पर https://mcp.bird.com आपके लिए रजिस्टर हो जाता है। OpenCode का प्लगइन भी सर्वर रजिस्टर करता है: डिफ़ॉल्ट रूप से https://mcp.bird.com/dynamic, या OpenCode का प्रायोगिक कोड मोड चालू होने पर पूरा https://mcp.bird.com। Bird की Cursor Marketplace लिस्टिंग और Antigravity प्लगइन में भी सर्वर शामिल है। Codex और ChatGPT में Bird प्लगइन में Bird का MCP सर्वर और स्किल्स शामिल हैं। Copilot पर प्लगइन स्किल्स इंस्टॉल करता है; Droid पर आप स्किल फ़ाइलें हाथ से कॉपी करते हैं। Copilot और Droid में सर्वर को मैन्युअल रूप से जोड़ना होता है, जिसके लिए MCP सर्वर गाइड में दिया गया एक पंक्ति का कॉन्फ़िगरेशन इस्तेमाल करें।

कोई भी प्लगइन आपकी ओर से ऑथेंटिकेट नहीं कर सकता। होस्ट किया गया सर्वर OAuth से सुरक्षित है, इसलिए Claude Code सहित हर क्लाइंट पर सर्वर रजिस्टर होने के बाद आपको एक बार साइन इन करना होता है: Claude Code में /mcp चलाएँ, फिर bird चुनें, फिर Authenticate चुनें। जब तक आप ऐसा नहीं करते, टूल सूची में दिखते हैं पर हर कॉल विफल होती है। बाकी जानकारी हर क्लाइंट के लिए ऑथेंटिकेशन के चरणों में है।

अगले कदम

• अपना कोडिंग एजेंट सेट अप करें: एक प्रॉम्प्ट वाला सेटअप, जो आपके लिए प्लगइन इंस्टॉल करता है।
• MCP सर्वर: प्लगइन में शामिल टूल सतह, और इसे मैन्युअल रूप से जोड़ने का तरीका।
• एजेंट के लिए CLI: वह कमांड सतह जो स्किल सिखाती हैं, शेल चला सकने वाले एजेंट के लिए।
• AI ऑनबोर्डिंग: निर्देशित, शुरू से अंत तक का सेटअप, जिसमें दस्तावेज़ संग्रह पहले से जुड़ा होता है।