SKILL.md वैलिडेटर और फ़ॉर्मैट चेकर

Agent Skills एक खुला मानक है जो AI एजेंट को विशेष कार्य करने की क्षमता प्रदान करता है। किसी भी स्किल का मुख्य केंद्र एक फ़ोल्डर होता है जिसके भीतर SKILL.md नाम की फ़ाइल मौजूद होती है। यह फ़ाइल दो मुख्य भागों में विभाजित होती है: सबसे ऊपर YAML फ़्रंटमैटर और उसके नीचे Markdown प्रारूप में विस्तृत निर्देश।

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

SKILL.md वैलिडेटर आपके ब्राउज़र में ही फ़ाइल की जांच करता है। यह सुनिश्चित करता है कि आपकी फ़ाइल एजेंट स्किल्स मानक के सभी नियमों का पालन करती है, ताकि डिप्लॉयमेंट के बाद एजेंट बिना किसी रुकावट के आपके निर्देशों को निष्पादित कर सके।

SKILL.md फ़ाइल के शीर्ष पर स्थित YAML फ़्रंटमैटर तीन हाइफ़न से शुरू और समाप्त होना चाहिए। मानक विनिर्देश के अनुसार इसमें कुछ फ़ील्ड्स अनिवार्य हैं और कुछ वैकल्पिक। यदि कोई भी अनिवार्य फ़ील्ड छूट जाती है या अपनी सीमा पार करती है, तो वैलिडेटर उसे त्रुटि के रूप में चिह्नित करता है।

फ़ील्ड्स और उनके मुख्य नियमों का विवरण इस प्रकार है:

यदि आप फ़ोल्डर का नाम भी दर्ज करते हैं, तो name फ़ील्ड का मान फ़ोल्डर के नाम से पूरी तरह मेल खाना चाहिए। फ़्रंटमैटर सिंटैक्स की पुष्टि के लिए YAML से JSON परिवर्तक का उपयोग करके भी डेटा की संरचना जांची जा सकती है।

किसी भी स्किल के सही समय पर चलने के लिए description फ़ील्ड सबसे महत्वपूर्ण कड़ी है। AI मॉडल यह तय करने के लिए केवल इस विवरण को पढ़ता है कि वर्तमान कार्य के लिए यह स्किल उपयोगी है या नहीं। यदि विवरण अस्पष्ट या बहुत छोटा है, तो एजेंट स्किल को कभी लोड ही नहीं करेगा।

SKILL.md वैलिडेटर यह जांचता है कि विवरण कम से कम 60 वर्णों का हो। इसके साथ ही यह सलाह दी जाती है कि विवरण में दो बातें स्पष्ट रूप से लिखी हों: स्किल क्या करती है और इसे किस परिस्थिति में उपयोग करना चाहिए।

कमज़ोर विवरण का उदाहरण: description: PDF फ़ाइलों से डेटा निकालता है।

प्रभावी और अनुशंसित विवरण का उदाहरण: description: इनवॉइस और रसीद वाली PDF फ़ाइलों से संरचित वित्तीय डेटा निकालता है। इस स्किल का उपयोग तब करें जब उपयोगकर्ता बिलिंग दस्तावेज़ पार्स करने या टेबल निकालने का अनुरोध करे।

विवरण में 'Use when' या 'उपयोग तब करें' जैसे शब्दों को शामिल करने से एजेंट की निर्णय क्षमता सटीक हो जाती है।

फ़्रंटमैटर के नीचे का हिस्सा स्किल की बॉडी कहलाता है, जिसमें Markdown प्रारूप में चरणबद्ध निर्देश दिए जाते हैं। बॉडी में कम से कम 20 शब्द होने चाहिए ताकि एजेंट को काम करने के लिए पर्याप्त संदर्भ मिल सके।

मानक दिशा-निर्देशों के अनुसार बॉडी का आकार 500 पंक्तियों या लगभग 5,000 टोकन से कम होना चाहिए। गणना के लिए प्रति टोकन 4 वर्णों का अनुमान लगाया जाता है। यह ध्यान रखें कि देवनागरी या हिंदी पाठ में वास्तविक टोकन संख्या इस अनुमान से भिन्न हो सकती है।

यदि आपके निर्देश बहुत लंबे हैं, तो उन्हें छोटे भागों में विभाजित करें और मुख्य फ़ाइल में केवल आवश्यक प्रक्रिया रखें। अतिरिक्त संदर्भ, स्कीमा या बड़े उदाहरणों को references/ फ़ोल्डर में रखें। SKILL.md फ़ाइल से उन संदर्भ फ़ाइलों को रिलेटिव लिंक द्वारा जोड़ें। वैलिडेटर यह चेतावनी देता है यदि कोई लिंक एब्सोल्यूट पथ का उपयोग करता है या बहुत गहराई में नेस्टेड फ़ोल्डर की ओर इशारा करता है। इसके अतिरिक्त फ़ाइल में बचे हुए TODO या डमी टेक्स्ट को हटाना आवश्यक है।

कई डेवलपर्स ऐसी स्किल्स तैयार करते हैं जो विभिन्न प्रकार के AI एजेंट्स पर चल सकें। इसके लिए यह समझना ज़रूरी है कि कौन से फ़ील्ड्स मानक का हिस्सा हैं और कौन से किसी विशेष टूल द्वारा जोड़े गए हैं।

मानक एजेंट स्किल्स विनिर्देश में name, description, license, compatibility, और metadata शामिल हैं। दूसरी ओर model या hooks जैसे फ़ील्ड्स केवल Claude Code जैसे विशिष्ट वातावरण द्वारा पढ़े जाते हैं। अन्य एजेंट्स इन अतिरिक्त फ़ील्ड्स को अनदेखा कर देते हैं।

यदि आप ऐसे फ़ील्ड्स का उपयोग करते हैं, तो SKILL.md वैलिडेटर त्रुटि देने के बजाय एक सूचना (Note) प्रदर्शित करता है। यह आपको सूचित करता है कि आपकी फ़ाइल काम करेगी, लेकिन गैर-मानक फ़ील्ड्स की पोर्टेबिलिटी सीमित हो सकती है। यदि आप कस्टम डेटा जोड़ना चाहते हैं, तो उसे सीधे रूट लेवल पर रखने के बजाय metadata ऑब्जेक्ट के अंदर रखना सबसे सुरक्षित तरीका है।

SKILL.md वैलिडेटर में फ़ाइल पेस्ट करने पर आपको एक विस्तृत रिपोर्ट प्राप्त होती है। इस रिपोर्ट को तीन श्रेणियों में विभाजित किया जाता है:

1. त्रुटि (Error): विनिर्देश का सीधा उल्लंघन, जैसे अमान्य YAML, नाम में वर्जित वर्ण, या विवरण का न होना। शून्य त्रुटि होने पर ही फ़ाइल को मान्य माना जाता है।
2. चेतावनी (Warning): सर्वोत्तम प्रथाओं से विचलन, जैसे 60 वर्णों से छोटा विवरण, 500 से अधिक पंक्तियाँ, या बॉडी में प्लेसहोल्डर टेक्स्ट। चेतावनी होने पर भी फ़ाइल तकनीकी रूप से मान्य रहती है।
3. सूचना (Note): जानकारी देने वाले बिंदु, जैसे टूल-विशिष्ट फ़ील्ड्स का उपयोग।

यह टूल आपके निर्देशों की गुणवत्ता या लिंक्ड फ़ाइलों के अस्तित्व की जांच नहीं करता, बल्कि केवल प्रारूप और मानकों की पुष्टि करता है।

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