पैकेज रूट समझें

सोर्स बिल्ड में पैकेज निर्माण: इस पेज की कमांड के लिए पैकेज निर्माण की सुविधा वाले सोर्स बिल्ड चाहिए। वर्तमान इंस्टॉलर रिलीज़ में agentplugins author शामिल नहीं है।

चुनी गई डायरेक्टरी ही पैकेज रूट है। पैकेज निर्माण रूट plugin.json और उसके मानक घटक पढ़ता है। वह प्रोजेक्ट के लिए पैरेंट नहीं खोजता और नेटिव क्लाइंट के छिपे मेनिफ़ेस्ट का सहारा नहीं लेता।

न्यूनतम और संयुक्त संरचनाएँ

केवल Skill वाला पैकेज:

review-helper/
  plugin.json
  skills/
    review-docs/
      SKILL.md

दूरस्थ हाइब्रिड पैकेज:

research-helper/
  plugin.json
  mcp.json
  skills/
    research-guide/
      SKILL.md

Stdio पैकेज में रनटाइम स्रोत और निर्भरता मेनिफ़ेस्ट भी होते हैं। वे बाद के निष्पादन के लिए आवश्यक हैं, लेकिन उनके मौजूद होने से पैकेज निर्माण रीडर कुछ चलाता नहीं है।

हर फ़ाइल की ज़िम्मेदारी स्पष्ट रखें

फ़ाइल या डायरेक्टरी	ज़िम्मेदारी
plugin.json	मानक पैकेज की पहचान और मेटाडेटा।
mcp.json	टूल देने वाले पैकेज के MCP सर्वर का कॉन्फ़िगरेशन।
skills/<name>/SKILL.md	सीधे skills/ के भीतर रखे एक Skill की पहचान, विवरण और निर्देश।
README.md	इच्छित उपयोग, पूर्वापेक्षाएँ, वैलिडेशन और बाकी सीमाएँ।
package.json, package-lock.json, src/server.mjs	अलग रनटाइम कार्य के लिए Node stdio ढाँचे के इनपुट।
LICENSE	init के दौरान दी गई स्पष्ट रूप से चुनी लाइसेंस।

ढाँचे में मेनिफ़ेस्ट संस्करण 0.1.0 से शुरू होता है। यह नए पैकेज का मेटाडेटा है, पैकेज निर्माण एक्ज़ीक्यूटेबल का रिलीज़ संस्करण नहीं। उपयोगकर्ताओं को संस्करण बताते समय यह अंतर बनाए रखें।

पहचान और वैकल्पिक मेटाडेटा

दोहराए जा सकने वाले init निर्देशों में स्पष्ट --name और --description दें। सार्वजनिक अनुबंध केवल गंतव्य नाम से पैकेज नाम निकाल सकता है और एक नियत डिफ़ॉल्ट विवरण देता है, लेकिन ./review-helper जैसे पाथ के साथ स्पष्ट नाम देना चाहिए। ये ट्यूटोरियल दोनों देते हैं ताकि पहचान अनजाने में न चुनी जाए।

Skill वाले टेम्प्लेट में --skill-name छोड़ने पर उसका डिफ़ॉल्ट पैकेज नाम होता है। अलग पहचान चाहिए तो उसे स्पष्ट चुनें। Skill नाम कभी चुपचाप सामान्यीकृत नहीं किए जाते।

वैकल्पिक --author-name से स्पष्ट लेखक दिया जाता है। Git या परिवेश से लेखक नहीं निकाला जाता। लाइसेंस निर्माण स्पष्ट MIT या ISC चयन का समर्थन करता है और उसके लिए --copyright-holder तथा चार अंकों वाला --copyright-year दोनों चाहिए। कोई डिफ़ॉल्ट लाइसेंस नहीं चुना जाता।

रूट लगातार एक ही रखें

agentplugins author validate ./research-helper
agentplugins author inspect ./research-helper
agentplugins author test ./research-helper

तीनों एक ही पैकेज रूट चुनते हैं। ./research-helper/skills देना गलत डायरेक्टरी चुनेगा। पढ़ने वाली कमांड का वैकल्पिक पाथ केवल वर्तमान डायरेक्टरी पर डिफ़ॉल्ट होता है, खोजे गए किसी पैरेंट पर नहीं।

मानक अनुपालन और फ़ाइल सिस्टम सुरक्षा अलग विषय हैं। स्कीमा के अनुसार वैध पहचान भी होस्ट पाथ के लिए अनुपयुक्त हो सकती है। केवल पढ़ा जा सकने वाला मेनिफ़ेस्ट आवश्यक घटकों के अधूरे प्रमाण छोड़ सकता है। पूरी रिपोर्ट इस्तेमाल करें।

आगे स्थिर जाँचें, फिर पैकेज सौंपना देखें।