Anthropic आधिकारिक एजेंट स्किल्स ट्यूटोरियल: 6-लेसन कोर्स के पूर्ण नोट्स

Anthropic ने आखिरकार एक आधिकारिक Agent Skills ट्यूटोरियल वीडियो जारी किया है, जिसमें 6 पाठ हैं और कुल अवधि 22 मिनट है। यह Skills के पूरे जीवनचक्र को कवर करता है, जिसमें यह भी शामिल है कि वे क्या हैं, उन्हें कैसे बनाएं, मल्टी-फ़ाइल सेटअप कॉन्फ़िगर करें, उन्हें अन्य सुविधाओं से अलग करें, उन्हें साझा करें और समस्या निवारण करें।

इस ट्यूटोरियल का सबसे बड़ा मूल्य केवल आपको Skill लिखना सिखाना नहीं है, बल्कि Skills के डिज़ाइन दर्शन और अंतर्निहित तंत्रों की व्याख्या करना है। Skills का उपयोग करते समय लोगों को जिन कई समस्याओं का सामना करना पड़ता है, वे इन तंत्रों की अपर्याप्त समझ से उत्पन्न होती हैं।

Skills किन समस्याओं का समाधान करती हैं?

हर बार जब आप Claude को अपनी टीम के कोडिंग मानकों के बारे में समझाते हैं, तो आप खुद को दोहरा रहे होते हैं। हर PR समीक्षा में, आपको फिर से बताना पड़ता है कि आप फीडबैक को कैसे व्यवस्थित करना चाहते हैं। हर कमिट मैसेज में, आपको Claude को अपने पसंदीदा फ़ॉर्मेट की याद दिलानी पड़ती है।

Skills इस दोहराव को खत्म करने के लिए डिज़ाइन की गई हैं। एक Skill एक Markdown फ़ाइल है जो Claude को सिखाती है कि कुछ एक बार कैसे करना है, और Claude स्वचालित रूप से उस ज्ञान को प्रासंगिक स्थितियों में लागू करता है।

अधिक सटीक रूप से, एक Agent Skill एक फ़ोल्डर है जिसमें निर्देश, स्क्रिप्ट और संसाधन होते हैं। Claude स्वचालित रूप से इन्हें खोज और उपयोग कर सकता है ताकि काम को अधिक सटीक और कुशलता से पूरा किया जा सके।

मुख्य तंत्र description फ़ील्ड है। जब Claude शुरू होता है, तो वह सभी Skills के नाम और विवरण लोड करता है। जब आप कोई अनुरोध करते हैं, तो Claude आपके अनुरोध और सभी उपलब्ध Skills के विवरणों के बीच सिमैंटिक मैचिंग करता है ताकि मेल खाने वाली Skill को खोज और सक्रिय कर सके। सक्रियण पर ही पूरी Skill सामग्री कॉन्टेक्स्ट विंडो में लोड होती है।

यह claude.md से मौलिक रूप से अलग है। claude.md की सामग्री हर बातचीत में लोड होती है, चाहे आप कुछ भी कर रहे हों। एक Skill केवल ज़रूरत पड़ने पर लोड होती है; आपकी PR समीक्षा चेकलिस्ट को डीबगिंग के दौरान कॉन्टेक्स्ट में होने की आवश्यकता नहीं है, यह केवल तब दिखाई देती है जब आप वास्तव में समीक्षा का अनुरोध करते हैं।

आपको Skill का उपयोग कब करना चाहिए? यदि आप खुद को बार-बार Claude को एक ही चीज़ समझाते हुए पाते हैं, तो यह एक Skill विकसित करने का समय है।

अपनी पहली Skill स्क्रैच से बनाना

Skill बनाने के लिए केवल दो चरणों की आवश्यकता है: एक डायरेक्टरी बनाना और एक फ़ाइल लिखना।

चरण एक: ~/.claude/skills/ के अंतर्गत Skill के नाम पर एक डायरेक्टरी बनाएं। इसे यहाँ रखने का मतलब है कि यह एक व्यक्तिगत-स्तर की Skill है, जो सभी प्रोजेक्ट्स में उपलब्ध है।

चरण दो: डायरेक्टरी में एक SKILL.md फ़ाइल बनाएं। फ़ाइल दो भागों में विभाजित है, जो तीन डैश से अलग होते हैं। ऊपरी भाग YAML मेटाडेटा है जिसमें name और description होता है। निचले भाग में Claude के लिए पालन करने के लिए विशिष्ट निर्देश होते हैं।

जब Claude Code शुरू होता है, तो वह Skills के लिए चार स्थानों को स्कैन करता है: एंटरप्राइज़ पथ, व्यक्तिगत Skills डायरेक्टरी, प्रोजेक्ट Skills डायरेक्टरी और इंस्टॉल किए गए प्लगइन्स। यह प्रत्येक Skill का केवल नाम और विवरण लोड करता है, पूरी सामग्री नहीं।

जब आप कोई अनुरोध भेजते हैं, तो Claude अनुरोध की तुलना सभी Skill विवरणों से करता है। यदि इरादा मेल खाता है, तो वह पहले आपसे Skill लोड करने की पुष्टि करने के लिए कहेगा। पुष्टि के बाद ही वह पूरी फ़ाइल पढ़ता है और निर्देशों को निष्पादित करता है। यह पुष्टिकरण चरण आपको इस बात से अवगत रखता है कि Claude किस कॉन्टेक्स्ट का उपयोग कर रहा है।

यदि समान नाम वाली Skills मौजूद हैं, तो उच्च से निम्न प्राथमिकता है: एंटरप्राइज़ स्तर (managed-settings.json), व्यक्तिगत स्तर (~/.claude/skills), प्रोजेक्ट स्तर (project/.claude/skills) और प्लगइन स्तर (project/.claude-plugins/skills).

इसका मतलब है कि एक कंपनी एंटरप्राइज़-स्तरीय Skills के माध्यम से मानकों को लागू कर सकती है, जबकि व्यक्तियों को अलग-अलग नामों वाली Skills के माध्यम से अनुकूलित करने की अनुमति देती है। यदि आपकी कंपनी के पास एक एंटरप्राइज़ कोड समीक्षा Skill है, तो आप इसे ओवरराइट करने के बजाय पूरक करने के लिए front-end-pr-review नामक एक व्यक्तिगत Skill बना सकते हैं।

उन्नत कॉन्फ़िगरेशन: मेटाडेटा फ़ील्ड और प्रोग्रेसिव डिस्क्लोज़र

बुनियादी Skills को केवल name और description की आवश्यकता होती है, लेकिन कई उन्नत कॉन्फ़िगरेशन Skills को अधिक शक्तिशाली बना सकते हैं।

allowed-tools फ़ील्ड सीमित कर सकता है कि Skill सक्रिय होने पर Claude किन टूल्स का उपयोग कर सकता है। उदाहरण के लिए, यदि आपके पास एक केवल-पढ़ने के लिए विश्लेषण Skill है, तो आप संपादन, लेखन और Bash कमांड को प्रतिबंधित कर सकते हैं। यदि यह फ़ील्ड छोड़ दिया जाता है, तो Skill कोई प्रतिबंध नहीं लगाती है, और Claude सामान्य अनुमति मॉडल का उपयोग करता है।

model फ़ील्ड निर्दिष्ट कर सकता है कि Claude मॉडल के किस संस्करण का उपयोग करना है।

description लिखने का तरीका सीधे यह निर्धारित करता है कि कोई Skill सही ढंग से ट्रिगर हो सकती है या नहीं। एक अच्छे विवरण को दो प्रश्नों का उत्तर देना चाहिए: यह Skill क्या करती है? Claude को इसका उपयोग कब करना चाहिए? यदि कोई Skill ट्रिगर नहीं होती है, तो अपने अनुरोधों के वाक्यांश से मेल खाने वाले अधिक कीवर्ड जोड़ें।

सबसे महत्वपूर्ण उन्नत अवधारणा प्रोग्रेसिव डिस्क्लोज़र है। Skills आपकी बातचीत के साथ कॉन्टेक्स्ट विंडो साझा करती हैं। यदि आप सब कुछ 20,000-लाइन SKILL.md में ठूंस देते हैं, तो यह भारी मात्रा में कॉन्टेक्स्ट स्पेस की खपत करेगा।

सही दृष्टिकोण है: आवश्यक निर्देशों को SKILL.md में रखें और विस्तृत संदर्भ सामग्री को अलग-अलग फ़ाइलों में रखें, जिन्हें Claude केवल ज़रूरत पड़ने पर पढ़ता है। खुले मानकों के लिए अनुशंसित डायरेक्टरी संरचना है: निष्पादन योग्य कोड के लिए scripts फ़ोल्डर, संदर्भ दस्तावेज़ों के लिए references और छवियों और टेम्पलेट्स जैसी डेटा फ़ाइलों के लिए resources। इन फ़ाइलों को संदर्भित करने के लिए SKILL.md में लिंक का उपयोग करें।

मुख्य नियम: SKILL.md 500 लाइनों से अधिक नहीं होनी चाहिए। यदि ऐसा है, तो इसे विभाजित किया जाना चाहिए। स्क्रिप्ट को सीधे निष्पादित किया जा सकता है, बिना उनकी सामग्री को कॉन्टेक्स्ट में लोड किए; केवल आउटपुट टोकन की खपत करता है। इसलिए, Claude को स्क्रिप्ट पढ़ने के बजाय चलाने के लिए कहें। यह पर्यावरण सत्यापन और डेटा परिवर्तन के लिए विशेष रूप से उपयोगी है, क्योंकि परीक्षण की गई स्क्रिप्ट कोड ऑन-द-फ़्लाई जनरेशन की तुलना में अधिक विश्वसनीय है।

Skills और अन्य Claude Code सुविधाओं के बीच अंतर

Skills बनाम claude.md: claude.md हमेशा हर बातचीत में प्रोजेक्ट मानकों और नियमों के लिए लोड होता है जो हमेशा लागू होते हैं, जैसे "यह प्रोजेक्ट TypeScript सख्त मोड का उपयोग करता है।" Skills ऑन-डिमांड लोड होती हैं, केवल तब सक्रिय होती हैं जब Claude किसी अनुरोध से मेल खाता है।

Skills बनाम Sub Agents: Skills वर्तमान बातचीत में ज्ञान जोड़ती हैं; एक बार सक्रिय होने पर, निर्देश मौजूदा कॉन्टेक्स्ट में जोड़ दिए जाते हैं। Sub Agents एक स्वतंत्र कॉन्टेक्स्ट में चलते हैं, कार्यों को पूरा करते हैं और परिणाम अलग से प्रस्तुत करते हैं, मुख्य बातचीत से पूरी तरह अलग।

Skills बनाम Hooks: Hooks इवेंट-संचालित होते हैं, विशिष्ट घटनाओं के होने पर ट्रिगर होते हैं, जैसे हर बार जब कोई फ़ाइल सहेजी जाती है तो Claude Linter चलाता है। Skills अनुरोध-संचालित होती हैं, आपके द्वारा पूछे गए प्रश्नों के आधार पर सक्रिय होती हैं।

Skills बनाम MCP: MCP बाहरी टूल कनेक्शन प्रदान करता है, जिससे Claude Gmail या Notion जैसी सेवाओं को कॉल कर सकता है। Skills ज्ञान और वर्कफ़्लो प्रदान करती हैं, Claude को बताती हैं कि विशिष्ट कार्यों को पूरा करने के लिए उन टूल्स का उपयोग कैसे करें।

एक वाक्य में सारांश: claude.md में हमेशा-चालू निर्देश होते हैं, Skills में स्वचालित-मिलान विशेषज्ञता होती है, Sub Agents पृथक कॉन्टेक्स्ट में प्रत्यायोजित कार्य चलाते हैं, Hooks घटनाओं पर प्रतिक्रिया करते हैं, और MCP बाहरी टूल्स से जुड़ता है। इनका संयोजन में उपयोग किया जा सकता है।

Skills साझा करना: व्यक्तियों से टीमों से संगठनों तक

Skills का मूल्य साझा करने में निहित है। केवल आपके द्वारा उपयोग की जाने वाली PR समीक्षा Skill सहायक है, लेकिन एक टीम-साझा Skill कोड समीक्षाओं को मानकीकृत कर सकती है और एक सुसंगत अनुभव प्रदान कर सकती है।

साझा करने के तीन तरीके:

पहला है प्रोजेक्ट डायरेक्टरी। Skill को कोड रिपॉजिटरी की .claude/skills डायरेक्टरी में कमिट करें। रिपो को क्लोन करने वाला कोई भी व्यक्ति बिना अतिरिक्त इंस्टॉलेशन के स्वचालित रूप से ये Skills प्राप्त करता है। अगले पुल में अपडेट प्राप्त होते हैं। यह टीम कोडिंग मानकों और प्रोजेक्ट-विशिष्ट वर्कफ़्लो के लिए उपयुक्त है।

दूसरा है प्लगइन्स। प्लगइन्स को प्रोजेक्ट्स में Skills वितरित करने के एक तरीके के रूप में सोचें। एक बार ऐप स्टोर पर अपलोड होने के बाद, अन्य उपयोगकर्ता उन्हें डाउनलोड और इंस्टॉल कर सकते हैं। यदि आपकी Skill सामान्य है और प्रोजेक्ट-विशिष्ट नहीं है, तो यह समुदाय के सदस्यों के लिए सबसे अच्छा विकल्प है।

तीसरा है एंटरप्राइज़ परिनियोजन। प्रशासक प्रबंधित सेटिंग्स के माध्यम से पूरे संगठन में Skills को पुश करते हैं। एंटरप्राइज़-स्तरीय Skills की उच्चतम प्राथमिकता होती है और वे समान नाम वाली व्यक्तिगत और प्रोजेक्ट Skills को ओवरराइट करेंगी। इसका उपयोग अनिवार्य मानकों, सुरक्षा आवश्यकताओं और अनुपालन वर्कफ़्लो के लिए किया जाता है।

एक महत्वपूर्ण नोट: Sub Agents स्वचालित रूप से आपकी Skills प्राप्त नहीं करते हैं। जब आप किसी उप-एजेंट को कोई कार्य सौंपते हैं, तो वह एक नए कॉन्टेक्स्ट से शुरू होता है। बिल्ट-इन एजेंट (Explorer, Plan, Verify) Skills तक बिल्कुल भी पहुँच नहीं सकते हैं; केवल आपके द्वारा परिभाषित कस्टम उप-एजेंट ही उनका उपयोग कर सकते हैं, और उन्हें agent.md में स्पष्ट रूप से सूचीबद्ध किया जाना चाहिए।

Skills के साथ एक कस्टम उप-एजेंट बनाने के लिए, .claude/agents डायरेक्टरी में एक agent.md फ़ाइल बनाएं और आवश्यक Skill नामों को सूचीबद्ध करते हुए एक skills फ़ील्ड जोड़ें। केवल उन Skills को सूचीबद्ध करें जो हमेशा उप-एजेंट के लक्ष्य के लिए प्रासंगिक हों, क्योंकि ये Skills उप-एजेंट के शुरू होने पर लोड होंगी।

समस्या निवारण गाइड: Skills के विफल होने के छह कारण और उनके समाधान

Skill की समस्याएं आमतौर पर छह श्रेणियों में आती हैं:

1. Skill ट्रिगर नहीं हो रही है: कारण लगभग हमेशा एक खराब लिखा गया description होता है। Claude सिमैंटिक मैचिंग का उपयोग करता है; आपके अनुरोध को विवरण के अर्थ के साथ संरेखित करने की आवश्यकता है। यदि पर्याप्त ओवरलैप नहीं है, तो यह मेल नहीं खाएगा। समाधान: विवरण की तुलना अपने अनुरोध वाक्यांश से करें और उपयोगकर्ता वास्तव में जो ट्रिगर वाक्यांश कहते हैं, उन्हें जोड़ें, जैसे "मेरी मदद करें विश्लेषण करने में," "यह धीमा क्यों है," या "इसे गति दें।"

1. Skill लोड होने में विफल: पथ और फ़ाइल नामों की जाँच करें। SKILD.md को एक नामित डायरेक्टरी के अंदर होना चाहिए, सीधे skills रूट में नहीं। फ़ाइल का नाम बिल्कुल SKILL.md होना चाहिए, सभी बड़े अक्षरों में। लोडिंग त्रुटियों को देखने के लिए claude --debug चलाएं।

1. Claude गलत Skill का उपयोग कर रहा है: इसका मतलब है कि आपके पास कई Skills हैं जिनके विवरण बहुत समान हैं, जिससे Claude उनके बीच अंतर करने में असमर्थ है। समाधान: प्रत्येक विवरण को यथासंभव विशिष्ट बनाएं ताकि Claude को यह तय करने में मदद मिल सके कि कब किसका उपयोग करना है।

1. व्यक्तिगत Skill को अनदेखा किया जा रहा है: समान नाम वाली एक उच्च-प्राथमिकता वाली Skill (जैसे एंटरप्राइज़) इसे ओवरराइट कर सकती है। चार प्राथमिकता स्तरों की जाँच करें। समाधान: अपनी Skill का नाम बदलकर कुछ अधिक अद्वितीय रखें।

1. प्लगइन इंस्टॉल है लेकिन Skill दिखाई नहीं दे रही है: rm ~/.claude/plugins/cache के साथ कैश साफ़ करें, Claude Code को पुनरारंभ करें और पुनः इंस्टॉल करें। यदि यह अभी भी काम नहीं करता है, तो प्लगइन की डायरेक्टरी संरचना गलत हो सकती है; जाँच करने के लिए सत्यापन टूल skills-ref validate का उपयोग करें।

1. Skill लोड हो गई है लेकिन निष्पादन के दौरान विफल हो रही है: यदि Skill बाहरी पैकेजों का उपयोग करती है, तो सुनिश्चित करें कि वे इंस्टॉल हैं। Skill के विवरण में निर्भरता की जानकारी जोड़ें।

Anthropic एक सत्यापन टूल भी प्रदान करता है जिसे skills-ref कहा जाता है, यह जाँचने के लिए कि Skill की फ़ाइल संरचना और YAML सिंटैक्स सही हैं या नहीं। सबसे तेज़ विधि के लिए इसे uv के माध्यम से इंस्टॉल करने की अनुशंसा की जाती है।