Claude Code plugins: इंस्टॉल, जाँच और हटाने का तरीका

Plugin तब उपयोगी है जब निर्देश या टूल कई प्रोजेक्ट में ले जाने हों। इंस्टॉलेशन जाँचने के लिए अनजान hooks वाला बाहरी पैकेज ज़रूरी नहीं। अपना छोटा plugin बनाएँ, जिसमें स्पष्ट रूप से बुलाई जाने वाली एक skill हो और वह तय मार्कर लौटाए।

उदाहरण macOS/Linux और पहले से कॉन्फ़िगर किए गए Claude Code के लिए है। Windows में वही JSON और Markdown एडिटर से बनाए जा सकते हैं; shell commands Bash या Zsh के लिए हैं। मॉडल के जवाब के लिए काम करता कनेक्शन चाहिए। संरचना की जाँच अलग है।

तीन फ़ाइलें बनाएँ

एक नई खाली directory में:

mkdir -p plugin-lab/.claude-plugin
mkdir -p plugin-lab/plugins/load-check/.claude-plugin
mkdir -p plugin-lab/plugins/load-check/skills/ping

Manifest को plugin-lab/plugins/load-check/.claude-plugin/plugin.json में रखें:

{
  "name": "load-check",
  "version": "1.0.0",
  "description": "Local plugin loading exercise"
}

plugin-lab/plugins/load-check/skills/ping/SKILL.md में:

---
description: Return a marker to verify this local plugin is loaded.
disable-model-invocation: true
---

Return exactly PLUGIN_READY. Do not use tools or change files.

plugin-lab/.claude-plugin/marketplace.json में:

{
  "name": "local-load-lab",
  "owner": {"name": "Local developer"},
  "plugins": [
    {"name": "load-check", "source": "./plugins/load-check"}
  ]
}

Marketplace पैकेज की जगह बताता है। पैकेज के भीतर .claude-plugin में manifest रहता है और skills उसके साथ वाली directory है। skills को .claude-plugin के अंदर रखने पर आधिकारिक संरचना का पालन नहीं होगा।

संरचना जाँचें और इंस्टॉल करें

शुरुआती directory से:

claude --version
claude plugin validate ./plugin-lab/plugins/load-check
claude plugin validate ./plugin-lab
claude

Validator गलती बताए तो पहले संबंधित फ़ाइल सुधारें। सही संरचना निर्देशों की गुणवत्ता या किसी भी plugin की सुरक्षा का प्रमाण नहीं है।

Claude Code session में:

/plugin marketplace add ./plugin-lab
/plugin install load-check@local-load-lab

इंस्टॉलेशन पैनल में Local चुनें, ताकि यह प्रयोग मौजूदा प्रोजेक्ट तक रहे। पुष्टि करने से पहले देखें कि सेटिंग कहाँ लिखी जाएगी। सारांश में plugins reload करने को कहा जाए तो /reload-plugins चलाएँ। क्रम आधिकारिक marketplace गाइड में है।

सही skill लोड होने की पुष्टि करें

/plugin list
/load-check:ping

पहला command इंस्टॉल किया गया पैकेज दिखाना चाहिए और दूसरा PLUGIN_READY लौटाना चाहिए। पूरा नाम /load-check:ping plugin का नाम भी शामिल करता है, जिससे दूसरे पैकेज की समान नाम वाली skill से अंतर स्पष्ट रहता है।

Working directory भी जाँचें: इस skill को फ़ाइलें नहीं बदलनी चाहिए। टूल इस्तेमाल न करने वाला वाक्य मॉडल को दिया निर्देश है, अलग सिस्टम अनुमति-सीमा नहीं। पहुँच नियंत्रित करने के लिए Claude Code permissions इस्तेमाल करें।

Command न दिखे तो क्रम से manifest का नाम, skills/ping/SKILL.md की जगह, इंस्टॉलेशन दायरा, enabled स्थिति और reload की ज़रूरत जाँचें। Marketplace से loading और --plugin-dir से शुरुआत को अलग-अलग परीक्षण रखें।

बंद करें, अपडेट करें और हटाएँ

claude plugin disable load-check@local-load-lab --scope local
claude plugin enable load-check@local-load-lab --scope local
claude plugin update load-check@local-load-lab --scope local
claude plugin uninstall load-check@local-load-lab --scope local

उसी प्रोजेक्ट से एक-एक command चलाकर परिणाम जाँचें। --scope local चुने गए दायरे से मेल खाता है; इसके बिना update और uninstall का डिफ़ॉल्ट user है। अपडेट के बाद CLI कहे तो session दोबारा शुरू करें। बंद करने या हटाने के बाद नया session खोलकर देखें कि skill उपलब्ध नहीं है। चालू करने के बाद छोटा परीक्षण दोहराएँ।

सामग्री में बदलाव जाँचने के लिए पहले मूल skill का मार्कर बदलें और पैकेज का संस्करण बढ़ाएँ। फिर plugin प्रबंधन गाइड के अनुसार marketplace और इंस्टॉल किया plugin अपडेट करें। मूल फ़ाइल बदलने से cache में रखी इंस्टॉल की गई प्रति आवश्यक रूप से नहीं बदलती।

बाहरी plugin लगाने से पहले

पैकेज की सामग्री पढ़ें। टेक्स्ट skill, shell command वाला hook और MCP server के प्रभाव अलग हैं। Commands, बाहरी सेवा के पते और secrets माँगने वाले निर्देश जाँचें। केवल इंस्टॉलेशन त्रुटि हटाने के लिए अतिरिक्त अनुमतियाँ न दें।

काम के प्रोजेक्ट में यही छोटा चक्र अपनाएँ: ज्ञात दायरा, दिखता घटक, अपेक्षित काम, फ़ाइलों की जाँच और बंद करने का स्पष्ट तरीका। पूरा फ़ॉर्मैट और validator की क्षमताएँ plugins संदर्भ में हैं।