संदर्भ

marketplace.json स्कीमा

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

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

फ़ील्ड	आवश्यक	विवरण
$schema	नहीं	सत्यापन के लिए JSON स्कीमा 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)

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

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