संदर्भ

marketplace.json स्कीमा

मार्केटप्लेस मेनिफेस्ट रिपॉजिटरी रूट में .claude-plugin/marketplace.json पर स्थित होता है।

शीर्ष-स्तरीय फ़ील्ड

फ़ील्ड	आवश्यक	विवरण
$schema	नहीं	सत्यापन के लिए JSON Schema URL
name	हाँ	अद्वितीय मार्केटप्लेस पहचानकर्ता
version	नहीं	मार्केटप्लेस स्कीमा संस्करण (semver)
metadata.description	हाँ	मानव-पठनीय मार्केटप्लेस विवरण
owner.name	हाँ	मार्केटप्लेस का स्वामित्व रखने वाला संगठन या उपयोगकर्ता
owner.url	नहीं	स्वामी के प्रोफ़ाइल या वेबसाइट का URL
owner.email	नहीं	संपर्क ईमेल
plugins	हाँ	प्लगइन प्रविष्टियों की सरणी

प्लगइन प्रविष्टि फ़ील्ड

फ़ील्ड	आवश्यक	विवरण
name	हाँ	प्लगइन पहचानकर्ता (plugin.json से मेल खाना चाहिए)
description	हाँ	प्लगइन का संक्षिप्त विवरण
version	हाँ	सिमेंटिक वर्शन स्ट्रिंग
author.name	हाँ	प्लगइन लेखक
source	हाँ	प्लगइन का पथ या URL (स्रोत प्रकार देखें)
category	हाँ	प्लगइन श्रेणी (जैसे, productivity)
homepage	नहीं	प्लगइन दस्तावेज़ीकरण या होमपेज का URL
license	नहीं	SPDX लाइसेंस पहचानकर्ता
keywords	नहीं	खोज कीवर्ड की सरणी
tags	नहीं	फ़िल्टरिंग के लिए टैग की सरणी
repository	नहीं	रिपॉजिटरी URL

प्लगइन स्रोत प्रकार

marketplace.json में source फ़ील्ड कई प्रारूपों का समर्थन करती है:

प्रकार	उदाहरण	विवरण
सापेक्ष पथ	./plugins/example-plugin	उसी रिपॉजिटरी में प्लगइन
GitHub शॉर्टहैंड	owner/repo	रिपॉजिटरी रूट पर प्लगइन
पथ सहित GitHub	owner/repo/path/to/plugin	उपनिर्देशिका में प्लगइन
Git URL	https://github.com/owner/repo.git	Git रिपॉजिटरी
npm पैकेज	npm:@scope/package	प्रकाशित npm पैकेज

plugin.json स्कीमा

प्रत्येक प्लगइन की अपनी निर्देशिका में .claude-plugin/plugin.json पर एक मेनिफेस्ट होता है।

फ़ील्ड	आवश्यक	विवरण
name	हाँ	प्लगइन पहचानकर्ता
description	हाँ	प्लगइन क्या करता है
version	हाँ	सिमेंटिक संस्करण
author.name	हाँ	प्लगइन लेखक
author.url	नहीं	लेखक के प्रोफ़ाइल या वेबसाइट का URL
homepage	नहीं	दस्तावेज़ीकरण URL
keywords	नहीं	खोज कीवर्ड
license	नहीं	SPDX लाइसेंस पहचानकर्ता
repository	नहीं	रिपॉजिटरी URL

प्लगइन निर्देशिका लेआउट

plugins/example-plugin/
  .claude-plugin/
    plugin.json          # Plugin manifest (required)
  skills/
    skill-name/
      SKILL.md           # Skill definition (required per skill)
      references/        # Reference data files (optional)
  commands/
    command-name.md      # Command definition (one per command)
  agents/
    agent-name.md        # Agent definition (one per agent)
  README.md              # Plugin documentation (recommended)

पर्यावरण वेरिएबल

प्लगइन अपनी स्किल और कमांड फ़ाइलों में इन वेरिएबल का उपयोग कर सकते हैं:

वेरिएबल	विवरण
$\{CLAUDE_PLUGIN_ROOT\}	प्लगइन की रूट निर्देशिका का पूर्ण पथ

सत्यापन

अपने मार्केटप्लेस और प्लगइन मेनिफेस्ट को स्थानीय रूप से सत्यापित करें:

claude plugin validate .

यह जाँचता है:

• marketplace.json स्कीमा अनुपालन
• सभी संदर्भित प्लगइन निर्देशिकाएं मौजूद हैं
• प्रत्येक प्लगइन में एक वैध plugin.json है
• स्किल में उचित रूप से स्वरूपित SKILL.md फ्रंटमैटर है
• कमांड में आवश्यक फ्रंटमैटर फ़ील्ड हैं

टीम कॉन्फ़िगरेशन

मार्केटप्लेस को पूर्व-कॉन्फ़िगर करना

किसी भी रिपॉजिटरी में .claude/settings.json में जोड़ें:

{
  "extraKnownMarketplaces": [
    "f5-sales-demo/marketplace"
  ]
}

प्लगइन को पूर्व-सक्षम करना

{
  "enabledPlugins": [
    "f5xc-docs-tools@f5-sales-demo-marketplace"
  ]
}

संकेत

इन सेटिंग्स को अपनी रिपॉजिटरी में कमिट करने से यह सुनिश्चित होता है कि प्रत्येक टीम सदस्य को स्वचालित रूप से समान मार्केटप्लेस और प्लगइन कॉन्फ़िगरेशन प्राप्त होता है।

समस्या निवारण

मार्केटप्लेस नहीं मिला

सत्यापित करें कि मार्केटप्लेस जोड़ा गया था:

/plugin marketplace list

यदि अनुपस्थित हो, तो इसे पुनः जोड़ें:

/plugin marketplace add f5-sales-demo/marketplace

प्लगइन सक्रिय नहीं हो रहा

• पुष्टि करें कि प्लगइन इंस्टॉल है: /plugin list
• जाँचें कि आपका Claude Code संस्करण प्लगइन का समर्थन करता है (v1.0.33+)
• सत्यापित करें कि स्किल की ट्रिगर शर्तें आपके वर्तमान संदर्भ से मेल खाती हैं

स्किल स्वचालित रूप से ट्रिगर नहीं हो रहीं

स्किल SKILL.md फ्रंटमैटर में अपने description फ़ील्ड के आधार पर सक्रिय होती हैं। यदि कोई स्किल अपेक्षित रूप से सक्रिय नहीं हो रही:

• जाँचें कि विवरण ट्रिगर संदर्भ को सटीक रूप से वर्णित करता है
• वैकल्पिक उपाय के रूप में कमांड का सीधे उपयोग करें (जैसे, /f5xc-docs-tools:review-mdx)

समीक्षा के बाद बिल्ड त्रुटियाँ

प्लगइन समस्याओं की रिपोर्ट करता है लेकिन उन्हें स्वतः ठीक नहीं करता। सुझाए गए सुधारों को मैन्युअल रूप से लागू करें, फिर समाधान की पुष्टि के लिए समीक्षा पुनः चलाएं।