प्लगइन आपकी पहले से लिखी चीज़ों — कमांड, सबएजेंट, स्किल, हुक — को एक ऐसे फ़ोल्डर में समेटता है जिसे कोई और इंस्टॉल कर सके। मैनिफ़ेस्ट छोटा है और उस पर कोई विवाद भी नहीं, और इसीलिए उसमें हुई ग़लतियाँ इतनी खिझाती हैं: वह संस्करण जो संस्करण है ही नहीं, बड़े अक्षर वाला नाम, बिना स्कीम का पता। इनमें से कोई भी फ़ाइल को वैध JSON होने से नहीं रोकती, और सभी बाद में परेशानी खड़ी करती हैं। यह बिल्डर फ़ील्ड भरता है, नियम वाले फ़ील्ड जाँचता है, और वह बनावट दिखाता है जिसकी मैनिफ़ेस्ट अपने चारों ओर अपेक्षा करता है — क्योंकि अकेला मैनिफ़ेस्ट कुछ नहीं करता: लोड बग़ल के फ़ोल्डर होते हैं।
विशेषताएँ
नाम नामकरण नियमों से जाँचा जाता है
संस्करण सिमैंटिक संस्करण की तरह जाँचा जाता है, प्री-रिलीज़ समेत
लेखक का नाम और ईमेल सपाट करने के बजाय सही ढंग से नेस्टेड
पते में स्कीम है या नहीं यह जाँचा जाता है
ख़ाली फ़ील्ड ख़ाली लिखने के बजाय छोड़ दिए जाते हैं
मैनिफ़ेस्ट के बग़ल में फ़ोल्डर बनावट
कीवर्ड एक पंक्ति में एक
plugin.json के रूप में डाउनलोड
प्लगइन मैनिफ़ेस्ट बिल्डर का उपयोग कैसे करें
प्लगइन का नाम और शुरुआती संस्करण दीजिए
लिखिए कि वह क्या समेटता है
साझा करना हो तो लेखक, पता और लाइसेंस जोड़िए
plugin.json को .claude-plugin फ़ोल्डर में डाउनलोड कीजिए
उदाहरण
इनपुट
"version": "1.0"
आउटपुट
Error: not a semantic version — use major.minor.patch
दो हिस्सों वाला संस्करण अस्वीकार होने की सबसे आम वजह है।
सामान्य त्रुटियाँ और समस्या निवारण
संस्करण अस्वीकार हो गया। — सिमैंटिक संस्करण में तीन हिस्से होते हैं: 1.0.0, 1.0 नहीं। 1.0.0-beta.1 जैसा प्री-रिलीज़ प्रत्यय चल जाता है।
इंस्टॉल के बाद प्लगइन मिलता नहीं। — मैनिफ़ेस्ट प्लगइन फ़ोल्डर के भीतर .claude-plugin/plugin.json में जाता है, उसकी जड़ में नहीं। आउटपुट के नीचे की बनावट बताती है कि क्या कहाँ है।
नाम अस्वीकार हो गया। — छोटे अक्षर, अंक और इकहरे हाइफ़न। यह पहचानकर्ता की तरह इस्तेमाल होता है, इसलिए बड़े अक्षर और स्पेस नहीं चलेंगे।
मैनिफ़ेस्ट वैध है फिर भी कुछ लोड नहीं होता। — मैनिफ़ेस्ट सिर्फ़ प्लगइन का विवरण देता है। कमांड, एजेंट, स्किल और हुक बग़ल के फ़ोल्डरों से लोड होते हैं — ख़ाली प्लगइन, चाहे मैनिफ़ेस्ट कितना ही उम्दा हो, कुछ नहीं करता।
अक्सर पूछे जाने वाले प्रश्न
प्लगइन में क्या रह सकता है?
स्लैश कमांड, सबएजेंट परिभाषाएँ, स्किल और हुक का कोई भी मेल, हर एक मैनिफ़ेस्ट के बग़ल में अपने फ़ोल्डर में। ये सभी वैकल्पिक हैं: एक काम का कमांड देने वाला प्लगइन भी पूरा प्लगइन है।
सचमुच अनिवार्य फ़ील्ड कौन-से हैं?
व्यवहार में नाम। बाक़ी मेटाडेटा है जो उसे दूसरों के लिए उपयोगी बनाता है: विवरण ताकि पता चले यह क्या है, संस्करण ताकि बदलाव दिखे, और पता ताकि स्रोत मिल सके।
संस्करण कैसे तय करें?
जब तक चीज़ें हिल रही हों 0.1.0 से शुरू कीजिए, और पहले अंक को संगतता के वादे की तरह लीजिए। किसी कमांड का नाम बदलना या स्किल हटाना, उपयोग करने वाले के लिए तोड़ने वाला बदलाव है।
क्या लाइसेंस फ़ील्ड चाहिए?
सिर्फ़ तब जब आप साझा कर रहे हों। और अगर कर रहे हैं तो साफ़ लिख देना एक बातचीत बचा देता है: बिना लाइसेंस वाली रिपॉज़िटरी को दोबारा इस्तेमाल करना क़ानूनी रूप से असहज होता है, भले ही वह साफ़ तौर पर इसी के लिए बनी हो।
क्या पहले से मौजूद चीज़ों से प्लगइन बना सकते हैं?
आम तौर पर शुरुआत ऐसे ही होती है। जो कमांड और स्किल पहले से चल रहे हैं वे बिना बदलाव सही फ़ोल्डरों में चले जाते हैं; एकमात्र नई फ़ाइल मैनिफ़ेस्ट है।