विषय-सूची

जैसे-जैसे आप Claude Code का अधिक इस्तेमाल करते हैं, आपके पास अपने खुद के slash commands, अक्सर इस्तेमाल होने वाले subagents, MCP servers, और hooks इकट्ठा होते जाते हैं। एक plugin वह तंत्र है जो इन सबको एक इकाई में बंडल कर देता है जिसे आप version कर सकते हैं, साझा कर सकते हैं, और टीमों व प्रोजेक्ट्स के बीच पुनः इस्तेमाल कर सकते हैं, और एक marketplace वह जगह है जहाँ इन्हें वितरित किया जाता है (plugins अक्टूबर 2025 में public beta में आए; 2026 में एक आधिकारिक directory और /plugin search/list जोड़े गए)।

यह लेख plugin क्या है, इसकी संरचना, इसे कैसे इस्तेमाल करें, marketplaces, खुद बनाना और प्रकाशित करना, तथा वितरण scope और सुरक्षा को कवर करता है — आधिकारिक दस्तावेज़ों के आधार पर। पहले तीन मुख्य बातें। (1) एक plugin एक ही directory है जो "skills / commands / subagents / hooks / MCP servers" को बंडल करती है, जहाँ .claude-plugin/plugin.json manifest होता है। (2) marketplace जोड़ने के लिए /plugin और plugin जोड़ने के लिए install इस्तेमाल करें। (3) खुद बनाना आसान है — एक plugin.json और एक SKILL.md रखें, claude --plugin-dir से टेस्ट करें, और git के ज़रिए प्रकाशित करें।

CLAUDE CODE · PLUGINS

फीचर्स बंडल करें, फिर साझा करें

— skills, agents, hooks, MCP — एक ही कमांड से marketplace से इंस्टॉल

my-plugin/
.claude-plugin/plugin.json
skills/
agents/
hooks/
.mcp.json
commands/ …
/plugin marketplace add owner/repo
↓
/plugin install name@market
↓
✓ enabled — टीम के साथ साझा करें

एक plugin फीचर्स का एक बंडल है; एक marketplace उसका वितरण कैटलॉग है (एक git repo, आदि)।
आधिकारिक marketplace (claude.com/plugins) बिना किसी सेटअप के काम करता है, और खुद का प्रकाशन सिर्फ git से हो जाता है।

1. Claude Code plugin क्या है

आधिकारिक परिभाषा: एक plugin "एक स्व-निहित directory है जो Claude Code की कस्टम कार्यक्षमता को बंडल करती है ताकि उसे version, साझा, और पुनः इस्तेमाल किया जा सके।" एक ही plugin में निम्नलिखित का कोई भी संयोजन शामिल हो सकता है:

घटकस्थानभूमिका
Skillsskills/<name>/SKILL.mdऐसी क्षमताएँ जिन्हें Claude कार्य के अनुसार स्वतः बुलाता है (Skills की व्याख्या)
Slash commandscommands/उपयोगकर्ता द्वारा बुलाए जाने वाले /name commands (दस्तावेज़ अब skills की ओर ले जाते हैं)
Subagentsagents//agents में दिखने वाली कस्टम agent परिभाषाएँ
Hookshooks/hooks.jsonPostToolUse जैसी घटनाओं पर स्वतः चलते हैं
MCP servers.mcp.jsonबाहरी tool/data एकीकरण (MCP)
Manifest.claude-plugin/plugin.jsonमेटाडेटा: name, description, version, आदि।

संक्षेप में, एक plugin "एक Claude Code एक्सटेंशन है जिसे साझा करने योग्य रूप में बॉक्स कर दिया गया हो।" जिन कस्टमाइज़ेशनों को आप पहले अलग-अलग कॉन्फ़िगर करते थे, वे एक repo में इकट्ठे हो जाते हैं ताकि आपकी पूरी टीम वही सेटअप दोहरा सके। आप LSP servers, बैकग्राउंड मॉनिटर, और executables (bin/) भी शामिल कर सकते हैं, लेकिन शुरुआत के लिए ऊपर के छह ही पर्याप्त हैं।

2. Plugin की संरचना

लेआउट के बारे में एक महत्वपूर्ण नियम है: .claude-plugin/ के अंदर सिर्फ plugin.json जाता है। commands/, agents/, skills/, और hooks/ directories plugin root पर होती हैं (.claude-plugin/ के अंदर नहीं)।

my-plugin/
├── .claude-plugin/
│   └── plugin.json          # manifest — ONLY this file lives here
├── skills/
│   └── code-review/SKILL.md
├── agents/
│   └── security-reviewer.md
├── hooks/hooks.json
├── .mcp.json
└── README.md

एक न्यूनतम plugin.json manifest:

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0",
  "author": { "name": "Your Name" }
}

name पहचानकर्ता है और साथ ही skill namespace भी (एक skill को /my-first-plugin:hello की तरह बुलाया जाता है)। version वैकल्पिक है: अगर सेट किया जाए, तो उपयोगकर्ताओं को अपडेट तभी मिलते हैं जब आप उसे बढ़ाते हैं। अगर आप git के ज़रिए वितरण करते समय version छोड़ देते हैं, तो commit SHA version की तरह काम करता है (हर commit एक नया version होता है)।

3. इस्तेमाल कैसे करें — /plugin और marketplace

इंस्टॉल /plugin के ज़रिए होता है, जो एक टैब वाला मैनेजर खोलता है (Discover / Installed / Marketplaces / Errors)। मुख्य commands:

# Add a marketplace (the distribution catalog)
/plugin marketplace add anthropics/claude-code        # a GitHub owner/repo
/plugin marketplace add ./my-marketplace              # a local path
/plugin marketplace add https://example.com/marketplace.json

# Install / manage plugins (user scope by default)
/plugin install plugin-name@marketplace-name
/plugin enable  plugin-name@marketplace-name
/plugin disable plugin-name@marketplace-name
/plugin uninstall plugin-name@marketplace-name

# List (filter with --enabled / --disabled). /plugin also has a search bar
/plugin list
/plugin list --enabled

# Apply changes without restart
/reload-plugins

"एक marketplace जोड़ना" = "एक कैटलॉग रजिस्टर करना," जो अपने आप में कोई plugin इंस्टॉल नहीं करता — आप कैटलॉग जोड़ते हैं, फिर plugins को अलग-अलग install करते हैं। स्क्रिप्टिंग के लिए claude plugin install … जैसे गैर-इंटरैक्टिव CLI समतुल्य मौजूद हैं। अगर किसी plugin का बंडल किया गया MCP server कनेक्ट नहीं होता, तो MCP कनेक्शन एरर के समाधान देखें।

4. marketplace क्या है

एक marketplace एक कैटलॉग है जिसमें एक .claude-plugin/marketplace.json होता है जो plugins और प्रत्येक को कहाँ से लाना है, यह सूचीबद्ध करता है (एक git repo, एक local path, या एक hosted फ़ाइल)। आधिकारिक वाले हैं और एक community वाला है।

आधिकारिक / community marketplaces

· आधिकारिक (claude-plugins-official): Anthropic द्वारा क्यूरेट किया गया। पहली लॉन्च से ही स्वतः उपलब्ध, /plugin Discover के ज़रिए या claude.com/plugins पर ब्राउज़ करने योग्य। इसमें LSP plugins, बाहरी एकीकरण (github / linear / notion / slack / figma, आदि), PR-review टूलकिट, और बहुत कुछ शामिल है।

· Community (claude-plugins-community): तीसरे-पक्ष की प्रस्तुतियाँ जो स्वचालित सत्यापन और सुरक्षा स्क्रीनिंग पास कर चुकी हैं (हर एक एक commit SHA पर पिन की गई)। इसे /plugin marketplace add anthropics/claude-plugins-community से जोड़ें।

तो अगर आप सिर्फ plugins इस्तेमाल करना चाहते हैं, तो आधिकारिक marketplace तुरंत तैयार है। ज़रूरत के अनुसार community कैटलॉग या अपना खुद का आंतरिक कैटलॉग जोड़ें।

5. खुद बनाएँ और प्रकाशित करें

एक बनाना आश्चर्यजनक रूप से आसान है। शुरुआत एक manifest और एक skill रखकर, फिर स्थानीय रूप से टेस्ट करके करें।

# 1) Scaffold
mkdir -p my-first-plugin/.claude-plugin my-first-plugin/skills/hello
# write .claude-plugin/plugin.json and skills/hello/SKILL.md

# 2) Test without installing (a .zip works too)
claude --plugin-dir ./my-first-plugin

प्रकाशित करने के लिए, बस एक git repo की root में एक .claude-plugin/marketplace.json रखें। उपयोगकर्ता इसे /plugin marketplace add owner/repo से जोड़ते हैं।

{
  "name": "my-plugins",
  "owner": { "name": "Your Name" },
  "plugins": [
    {
      "name": "quality-review-plugin",
      "source": "./plugins/quality-review-plugin",
      "description": "Adds a quick code-review skill"
    }
  ]
}

Versioning इस क्रम में हल होती है: plugin.json में version → (अन्यथा) marketplace entry में version → (अन्यथा) commit SHA। अगर आप version पिन करते हैं, तो हर रिलीज़ पर उसे बढ़ाएँ (भूल गए, तो उपयोगकर्ता अपडेट नहीं होंगे)। प्रकाशन से पहले claude plugin validate . से सत्यापित करें। आधिकारिक community कैटलॉग में सूचीबद्ध होने के लिए, प्रस्तुति फ़ॉर्म के ज़रिए आवेदन करें (Team/Enterprise और अन्य शर्तें लागू)।

6. वितरण scope और सुरक्षा

इंस्टॉल का एक scope होता है: user (डिफ़ॉल्ट, सभी प्रोजेक्ट) / project (repo के सभी सहयोगी, .claude/settings.json में दर्ज) / local (सिर्फ आप, यही repo) / managed (एडमिन द्वारा वितरित, उपयोगकर्ता द्वारा संशोधन योग्य नहीं)। टीम वितरण के लिए, प्रोजेक्ट के .claude/settings.json में extraKnownMarketplaces और enabledPlugins रखें, और सदस्यों को जब वे फ़ोल्डर पर भरोसा करते हैं तब इंस्टॉल करने के लिए संकेत मिलता है।

⚠️ सुरक्षा: plugins मनमाना कोड चला सकते हैं

आधिकारिक दस्तावेज़ साफ़ कहते हैं कि "plugins आपके विशेषाधिकारों के साथ आपकी मशीन पर मनमाना कोड चला सकते हैं।" Anthropic तीसरे-पक्ष के plugins या उनके बंडल किए गए MCP servers को सत्यापित नहीं करता। केवल उन्हीं स्रोतों से इंस्टॉल करें जिन पर आप भरोसा करते हैं। संगठन strictKnownMarketplaces के साथ अनुमत स्रोतों को सीमित कर सकते हैं ([] पूर्ण लॉकडाउन के लिए), जिसे किसी भी network/filesystem op से पहले जाँचा जाता है। किसी ऐसे plugin के लिए जिसे आप नहीं जानते, इंस्टॉल करने से पहले उसका कोड समीक्षा करें।

सारांश

एक Claude Code plugin skills, slash commands, subagents, hooks, और MCP servers को एक directory में बंडल करता है जिसे आप version, साझा, और पुनः इस्तेमाल कर सकते हैं (manifest .claude-plugin/plugin.json है; commands/ आदि root पर जाते हैं)। इन्हें marketplaces के ज़रिए वितरित किया जाता है, और आधिकारिक वाला (claude.com/plugins) बिना किसी सेटअप के उपलब्ध है। इंस्टॉल करें /plugin marketplace add → /plugin install → (ज़रूरत के अनुसार) /plugin list, search, /reload-plugins से।

खुद का बनाना एक छोटा रास्ता है: एक plugin.json और एक SKILL.md रखें, claude --plugin-dir से टेस्ट करें, फिर एक git repo में एक marketplace.json रखकर प्रकाशित करें। Scopes हैं user / project / local / managed, टीम वितरण .claude/settings.json के ज़रिए। लेकिन plugins मनमाना कोड चला सकते हैं, इसलिए केवल भरोसेमंद प्रकाशकों से इंस्टॉल करें और संगठनों में strictKnownMarketplaces से स्रोतों को सीमित करें। Plugins hooks को भी बंडल कर सकते हैं, जो lifecycle के विभिन्न बिंदुओं पर अपने-आप चलते हैं—ये कैसे काम करते हैं, इसके लिए विस्तृत गाइड देखें। संबंधित: Claude Agent Skills, MCP, Claude Code Artifacts।

FAQ

Q. एक plugin और एक skill में क्या अंतर है?
A. एक skill एक plugin के अंदर के घटकों में से एक है। एक plugin एक वितरण इकाई (directory) है जो skills के साथ-साथ slash commands, subagents, hooks, और MCP servers को बंडल करती है। plugin अपने अक्सर इस्तेमाल होने वाले skills और commands को टीम तक पहुँचाने के लिए "बॉक्स" है; एक skill उस बॉक्स के अंदर के "निर्देश-पत्रों" में से एक है।

Q. मैं एक plugin कैसे इंस्टॉल करूँ?
A. पहले /plugin marketplace add owner/repo से एक marketplace (कैटलॉग) जोड़ें, फिर /plugin install plugin-name@marketplace-name से अलग-अलग इंस्टॉल करें। आधिकारिक marketplace (claude-plugins-official) पहली लॉन्च से ही स्वतः उपलब्ध है, और आप claude.com/plugins पर या /plugin Discover के ज़रिए ब्राउज़ कर सकते हैं। /plugin enable|disable से टॉगल करें; /plugin list से सूची देखें।

Q. क्या मैं अपना खुद का plugin बना और वितरित कर सकता हूँ?
A. हाँ। एक .claude-plugin/plugin.json (manifest) और एक skills/…/SKILL.md रखें, और claude --plugin-dir ./your-plugin के ज़रिए बिना इंस्टॉल किए टेस्ट करें। प्रकाशित करने के लिए, बस एक git repo की root में एक .claude-plugin/marketplace.json रखें; उपयोगकर्ता इसे /plugin marketplace add owner/repo से जोड़ते हैं। याद रखें: .claude-plugin/ के अंदर सिर्फ plugin.json जाता है — skills/ आदि root पर रहते हैं।

Q. versioning कैसे काम करती है?
A. यह इस तरह हल होती है: plugin.json में version → (अन्यथा) marketplace entry में version → (अन्यथा) git commit SHA। अगर आप version सेट करते हैं, तो उपयोगकर्ताओं तक अपडेट तभी पहुँचते हैं जब आप उसे बढ़ाते हैं, इसलिए हर रिलीज़ पर उसे बढ़ाएँ (वरना उपयोगकर्ता पुराने पर ही रहते हैं)। version छोड़ दें और हर commit एक नया version है। प्रकाशन से पहले claude plugin validate . से सत्यापित करें।

Q. क्या तीसरे-पक्ष के plugins सुरक्षित हैं?
A. बिना शर्त नहीं। आधिकारिक दस्तावेज़ बताते हैं कि एक plugin "आपके विशेषाधिकारों के साथ मनमाना कोड चला सकता है," और Anthropic तीसरे-पक्ष के plugins या उनके बंडल किए गए MCP को सत्यापित नहीं करता। केवल भरोसेमंद प्रकाशकों से इंस्टॉल करें, और अगर अनिश्चित हों तो कोड की समीक्षा करें। संगठन strictKnownMarketplaces के साथ अनुमत स्रोतों को सीमित कर सकते हैं ([] पूर्ण लॉकडाउन के लिए)।