Agent skills

Bird agent skills प्रकाशित करता है: पैकेज्ड प्रोसीजर फ़ाइलें जो एक कोडिंग agent को bird CLI वर्कफ़्लो सिखाती हैं। एक skill ऑपरेशन का happy path, पहले चलाने वाली state जाँचें, और वे traps देती है जो loop iterations बर्बाद करते हैं। यह मार्गदर्शन agent को --help आउटपुट से flags और failure modes दोबारा खोजे बिना सही command तक पहुँचने में मदद करता है।

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

हर रेफ़रेंस प्रति टास्क एक ऑपरेशन एन्कोड करता है। Agent वह चुनता है जो रिक्वेस्ट से मेल खाता हो। साझा प्रमाणीकरण पूर्वापेक्षा के अलावा, इनमें कोई क्रम नहीं है।

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

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

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

कोड उदाहरण

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

Cursor पर, marketplace जोड़ें और Settings > Plugins से bird प्लगइन इंस्टॉल करें। Codex पर, 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। Factory Droid के पास पढ़ने के लिए कोई प्लगइन फ़ॉर्मेट नहीं है: messagebird/bird-ai क्लोन करें और plugins/bird/skills/ से दोनों skill डायरेक्टरीज़ को मैन्युअली .factory/skills/ में कॉपी करें।

Skills

प्लगइन में दो skills हैं।

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

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

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

साझा पूर्वापेक्षा: पहले प्रमाणीकरण करें

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

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

कोड उदाहरण

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

अगर क्रेडेंशियल्स गायब हैं, तो skill agent को bird auth login के ज़रिए टास्क पर वापस भेजती है। प्रमाणीकरण ब्राउज़र का उपयोग करता है, headless होस्ट के लिए device-code flow के साथ, ताकि वर्कफ़्लो प्रमाणीकरण प्रॉम्प्ट पर रुके नहीं।

विफलताएँ हर जगह एक ही तरह दिखती हैं

क्योंकि हर ऑपरेशन लाइव API पर एक पतला wrapper है, विफलताएँ प्रति-skill error handling के बजाय CLI के एकसमान contract के ज़रिए वापस आती हैं:

डिफ़ॉल्ट रूप से JSON: सफलताएँ stdout पर structured JSON प्रिंट करती हैं और त्रुटियाँ stderr पर जाती हैं, ताकि agent का loop प्रॉज़ स्क्रैप किए बिना परिणाम पार्स कर सके।
Semantic exit codes: छह कोड में से एक agent को मैसेज पढ़ने से पहले विफलता की श्रेणी बताता है। पूरी table CLI में देखें। agent मैसेज पार्स किए बिना श्रेणी पर ब्रांच करता है: exit 4 का मतलब auth चरण दोबारा चलाएँ, और exit 3 का मतलब resource ID गलत है, इसलिए फिर से प्रयास करने से मदद नहीं मिलेगी।

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

Skills को agent loop में मिलाना

क्योंकि हर रेफ़रेंस machine-readable परिणाम वाला एक self-checking ऑपरेशन है, ये बिना glue code के एक loop में compose होते हैं। उदाहरण के लिए, "send the launch email and confirm it delivered" इस प्रकार विभाजित होता है:

प्रमाणीकरण: bird auth status चलाएँ; ज़रूरत हो तभी login करें।
एक sender खोजें: domains रेफ़रेंस का उपयोग करके किसी verified डोमेन पर एक from पता चुनें। Exit 0 और JSON में verified डोमेन का मतलब यह चरण पूरा है; अन्यथा, create-and-verify loop में जाएँ।
भेजें: email रेफ़रेंस का उपयोग करके bird email send … चलाएँ। एक सफल रिक्वेस्ट 202, एक em_… ID, और status: accepted लौटाती है।
परिणाम की पुष्टि करें: email रेफ़रेंस का फिर से उपयोग करके bird email get <em_…> तब तक चलाएँ जब तक काउंट्स delivered न दिखाएँ। अगर वे bounced दिखाते हैं, तो विफलता रिपोर्ट करें।

हर चरण की "done when" शर्त पिछले चरण के JSON आउटपुट से जाँची जा सकती है, और यही loop को विश्वसनीय बनाता है: agent को प्रॉज़ से state अनुमान लगाने की ज़रूरत नहीं।

Skills, प्लगइन, और MCP

Skills किसी agent को Bird की ओर इंगित करने के तीन तरीकों में से एक हैं, और ये एक-दूसरे से प्रतिस्पर्धा नहीं करतीं बल्कि परत दर परत काम करती हैं:

bird CLI execution surface है। skills मानती हैं कि agent shell-capable है और इसे चला सकता है।
MCP सर्वर उन agents के लिए विकल्प है जो commands चलाने के बजाय tools कॉल करते हैं; ऑपरेशन समतुल्य हैं, transport अलग है।
AI onboarding गाइडेड सेटअप पथ है जो किसी भी एक को मिनटों में कनेक्ट कर देता है।

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

कोई भी प्लगइन आपके लिए प्रमाणीकरण नहीं कर सकता। होस्टेड सर्वर OAuth-gated है, इसलिए Claude Code सहित हर क्लाइंट पर, सर्वर रजिस्टर होने के बाद आप एक बार साइन इन करते हैं: Claude Code में /mcp, फिर bird चुनें, फिर Authenticate। जब तक आप ऐसा नहीं करते, tools सूचीबद्ध रहते हैं और हर कॉल विफल होती है। प्रति-क्लाइंट प्रमाणीकरण चरण बाकी कवर करते हैं।

क्लाइंट	प्लगइन द्वारा skills	MCP सर्वर रजिस्टर्ड	साइन-इन
Claude Code	हाँ	हाँ, प्लगइन द्वारा डिक्लेयर किया गया	आप: /mcp > bird > Authenticate
Cursor	हाँ	मैन्युअल, remote सर्वर एक बार जोड़ें	आप: Tools & Integrations में Needs login
Codex	हाँ	मैन्युअल, remote सर्वर एक बार जोड़ें	आप: codex mcp login bird
GitHub Copilot	हाँ	मैन्युअल, remote सर्वर एक बार जोड़ें	VS Code पहली शुरुआत पर ब्राउज़र खोलता है
Factory Droid	मैन्युअल, skill फ़ाइलें कॉपी करें	मैन्युअल, remote सर्वर एक बार जोड़ें	आप: droid के अंदर /mcp
OpenCode	हाँ	हाँ, प्लगइन द्वारा डिक्लेयर किया गया	आप: opencode mcp auth bird

अगले चरण

अपना कोडिंग agent सेट अप करें: वन-प्रॉम्प्ट सेटअप जो आपके लिए प्लगइन इंस्टॉल करता है।
MCP सर्वर: प्लगइन द्वारा बंडल किया गया tool surface, और इसे मैन्युअली कैसे जोड़ें।
agents के लिए CLI: skills द्वारा सिखाया गया command surface, shell-capable agents के लिए।
AI onboarding: docs corpus जुड़ा हुआ गाइडेड, end-to-end सेटअप।

संबंधित संसाधन