समस्या निवारण कौशल

आप क्या सीखेंगे

अनुमानित समय: 15 मिनट

इस पाठ के अंत तक आप सक्षम होंगे:

संरचनात्मक समस्याओं को पकड़ने के लिए कौशल सत्यापनकर्ता का उपयोग करना
सामान्य कौशल ट्रिगरिंग और लोडिंग समस्याओं का निदान और समाधान करना
एंटरप्राइज़, व्यक्तिगत, प्रोजेक्ट और plugin कौशल के बीच कौशल प्राथमिकता संघर्षों को हल करना
रनटाइम त्रुटियों को डीबग करना जिनमें लापता निर्भरताएं, अनुमतियां और पथ समस्याएं शामिल हैं

(4 मिनट)

जब कौशल अपेक्षित रूप से काम नहीं करते हैं, तो समस्या आमतौर पर कुछ पूर्वानुमानित श्रेणियों में आती है। यह वीडियो प्रत्येक को देखता है — कौशल जो ट्रिगर नहीं होते हैं से लेकर प्राथमिकता संघर्षों तक रनटाइम विफलताओं तक — और आपको एक व्यवस्थित समस्या निवारण दृष्टिकोण देता है। आप कौशल सत्यापनकर्ता उपकरण के बारे में भी जानेंगे और लोडिंग समस्याओं का निदान करने के लिए claude --debug का उपयोग कैसे करें।

मुख्य बातें

कौशल सत्यापनकर्ता उपकरण से शुरू करें — यह अन्य चीजों को डीबग करने में समय बिताने से पहले संरचनात्मक समस्याओं को पकड़ता है
यदि कोई कौशल ट्रिगर नहीं होता है, तो कारण लगभग हमेशा विवरण है — ट्रिगर वाक्यांश जोड़ें जो आपके वास्तविक अनुरोध के तरीके से मेल खाते हैं
यदि कोई कौशल लोड नहीं होता है, तो जांचें कि SKILL. md एक नामित निर्देशिका के अंदर है (कौशल रूट पर नहीं) और फ़ाइल का नाम बिल्कुल SKILL. md है
यदि गलत कौशल का उपयोग होता है, तो आपके विवरण बहुत समान हैं — उन्हें अधिक अलग बनाएं
रनटाइम त्रुटियों के लिए, निर्भरताओं, फ़ाइल अनुमतियों (chmod +x), और पथ विभाजकों (हर जगह फॉरवर्ड स्लैश का उपयोग करें) की जांच करें

जब कौशल काम नहीं करते हैं, तो समस्या आमतौर पर कुछ श्रेणियों में से एक में आती है: कौशल ट्रिगर नहीं होता है, लोड नहीं होता है, संघर्ष होता है, या रनटाइम पर विफल होता है। अच्छी खबर यह है कि अधिकांश समाधान काफी सीधे हैं।

कौशल सत्यापनकर्ता का उपयोग करें

पहली चीज़ जो आप कर सकते हैं वह है agent कौशल सत्यापनकर्ता कमांड का उपयोग करना। स्थापना के चरण ऑपरेटिंग सिस्टम के अनुसार भिन्न होते हैं, लेकिन uv का उपयोग करना इसे जल्दी से सेट करने का सबसे आसान तरीका है।

एक बार स्थापित होने के बाद, अपनी कौशल निर्देशिका में नेविगेट करें या कहीं से भी कमांड चलाएं। सत्यापनकर्ता अन्य चीजों को डीबग करने में समय बिताने से पहले संरचनात्मक समस्याओं को पकड़ेगा।

कौशल ट्रिगर नहीं होता है

आपका कौशल मौजूद है और सत्यापन पास करता है, लेकिन Claude इसका उपयोग नहीं कर रहा है जब आप उम्मीद करते हैं। कारण लगभग हमेशा विवरण है।

Claude सिमेंटिक मिलान का उपयोग करता है, इसलिए आपके अनुरोध को विवरण के अर्थ के साथ ओवरलैप करने की आवश्यकता है। यदि पर्याप्त ओवरलैप नहीं है, तो कोई मेल नहीं। यहाँ क्या करना है:

अपने विवरण की जांच करें कि आप वास्तव में अनुरोध कैसे कर रहे हैं
ट्रिगर वाक्यांश जोड़ें जो उपयोगकर्ता वास्तव में कहेंगे
"इसे प्रोफाइल करने में मेरी मदद करें," "यह धीमा क्यों है? ", "इसे तेज़ बनाएं" जैसी भिन्नताओं के साथ परीक्षण करें
यदि कोई भी भिन्नता ट्रिगर करने में विफल रहती है, तो उन कीवर्ड को अपने विवरण में जोड़ें

कौशल लोड नहीं होता है

यदि आपका कौशल तब दिखाई नहीं देता है जब आप Claude से पूछते हैं "कौन से कौशल उपलब्ध हैं," तो इन संरचनात्मक आवश्यकताओं की जांच करें:

SKILL. md फ़ाइल एक नामित निर्देशिका के अंदर होनी चाहिए, कौशल रूट पर नहीं
फ़ाइल का नाम बिल्कुल SKILL. md होना चाहिए — "SKILL" पर सभी कैप्स, लोअरकेस "md"

लोडिंग त्रुटियों को देखने के लिए claude --debug चलाएं। अपने कौशल का नाम बताने वाले संदेशों को देखें। कभी-कभी यह अकेले ही आपको सीधे समस्या की ओर इशारा करेगा।

गलत कौशल का उपयोग होता है

यदि Claude गलत कौशल का उपयोग करता है या कौशल के बीच भ्रमित प्रतीत होता है, तो आपके विवरण शायद बहुत समान हैं। उन्हें अलग बनाएं। जितना संभव हो सके विशिष्ट होना न केवल Claude को यह तय करने में मदद करता है कि आपके कौशल का उपयोग कब करना है — यह अन्य समान-ध्वनि वाले कौशल के साथ संघर्षों को भी रोकता है।

कौशल प्राथमिकता संघर्ष

यदि आपका व्यक्तिगत कौशल अनदेखा किया जा रहा है, तो एक एंटरप्राइज़ या उच्च-प्राथमिकता कौशल का नाम समान हो सकता है।

उदाहरण के लिए, यदि कोई एंटरप्राइज़ "code-review" कौशल है और आपके पास भी एक व्यक्तिगत "code-review" कौशल है, तो एंटरप्राइज़ वाला हर बार जीतता है। आपके विकल्प:

अपने कौशल का नाम कुछ अधिक अलग में बदलें (यह आमतौर पर आसान रास्ता है)
एंटरप्राइज़ कौशल के बारे में अपने admin से बात करें

Plugin कौशल दिखाई नहीं दे रहे हैं

एक plugin स्थापित किया लेकिन इसके कौशल नहीं देख सकते? कैश साफ़ करें, Claude Code को पुनः शुरू करें, और पुनः स्थापित करें।

यदि उसके बाद भी कौशल दिखाई नहीं देते हैं, तो plugin संरचना गलत हो सकती है। यह वह समय है जब सत्यापनकर्ता उपकरण वास्तव में अपना काम करता है।

रनटाइम त्रुटियां

कौशल लोड होता है लेकिन निष्पादन के दौरान विफल हो जाता है। कुछ सामान्य कारण:

लापता निर्भरताएं: यदि आपका कौशल बाहरी पैकेज का उपयोग करता है, तो उन्हें स्थापित किया जाना चाहिए। अपने कौशल विवरण में निर्भरता जानकारी जोड़ें ताकि Claude जान सके कि क्या आवश्यक है।
अनुमति समस्याएं: स्क्रिप्ट को निष्पादन अनुमति की आवश्यकता है। अपने कौशल द्वारा संदर्भित किसी भी स्क्रिप्ट पर chmod +x चलाएं।
पथ विभाजक: हर जगह फॉरवर्ड स्लैश का उपयोग करें, यहां तक कि Windows पर भी।

त्वरित समस्या निवारण चेकलिस्ट

**ट्रिगर नहीं हो रहा है? ** अपने विवरण में सुधार करें और ट्रिगर वाक्यांश जोड़ें।
**लोड नहीं हो रहा है? ** अपने पथ, फ़ाइल नाम और YAML सिंटैक्स की जांच करें।
**गलत कौशल का उपयोग हो रहा है? ** विवरणों को एक दूसरे से अधिक अलग बनाएं।
**छाया में है? ** प्राथमिकता पदानुक्रम की जांच करें और यदि आवश्यक हो तो नाम बदलें।
**Plugin कौशल लापता हैं? ** कैश साफ़ करें और पुनः स्थापित करें।
**रनटाइम विफलता? ** निर्भरताओं, अनुमतियों और पथों की जांच करें।

पाठ प्रतिबिंब

क्या आपने अपने स्वयं के काम में इनमें से कोई भी समस्या निवारण परिदृश्य का सामना किया है? कौन सी मरम्मत आपको सबसे अधिक समय बचाती?
आप अपनी टीम के साथ साझा करने से पहले कौशल को सत्यापित करने के लिए एक प्रक्रिया कैसे स्थापित करेंगे?

कोर्स समापन

Agent कौशल परिचय पूरा करने के लिए बधाई! आपने सीखा है कि Claude Code में कौशल कैसे बनाएं, कॉन्फ़िगर करें, साझा करें और समस्या निवारण करें। जब आप अपने स्वयं के वर्कफ़्लो के लिए कौशल बनाना शुरू करते हैं, तो याद रखें कि सर्वोत्तम कौशल वास्तविक दर्द बिंदुओं से आते हैं — उन निर्देशों से शुरू करें जो आप सबसे अधिक दोहराते हुए पाते हैं।

प्रतिक्रिया

हम सुनना पसंद करेंगे कि आप अपने काम में कौशल का उपयोग कैसे कर रहे हैं, साथ ही इस कोर्स के बारे में कोई भी प्रतिक्रिया। अपनी प्रतिक्रिया यहाँ साझा करें।