जो स्किल कभी चलती ही नहीं, उसमें व्याकरण की गड़बड़ी शायद ही होती है। वह लोड होती है, सूची में दिखती है, और कभी चुनी नहीं जाती — क्योंकि विवरण यह नहीं कहता कि वह कब लागू है, या ऐसे शब्दों में कहता है जो कोई नहीं बोलता। यह विफलता बनावट से ही चुप है: न त्रुटि, न चेतावनी, न कोई इशारा कि कुछ गड़बड़ है। यह लिंटर फ़ाइल को वैसे ही पढ़ता है जैसे लोडर पढ़ता है, बिगड़े हिस्सों की सूचना देता है, और फिर लगभग सारा ध्यान विवरण पर लगाता है: ट्रिगर नामित है या नहीं, लंबाई पर्याप्त है या नहीं, और शुरुआत यह दोहराने से तो नहीं होती कि यह एक स्किल है। जिन फ़ील्ड को लोडर पढ़ता ही नहीं, वे भी बताए जाते हैं, क्योंकि कुंजी में हुई ग़लती ठीक वैसी दिखती है जैसी एक सही फ़ाइल।
विशेषताएँ
फ्रंटमैटर असली YAML पार्सर से पढ़ता है और बताता है कहाँ टूटा
लोडर जिन फ़ील्ड को नहीं पढ़ता उन्हें दिखाता है — कुंजी की ग़लती ऐसी ही दिखती है
विवरण में ट्रिगर वाक्यांश और लंबाई की जाँच
विवरण की अक्षर संख्या सीमा के सामने रखकर बताता है
निर्देश उस लंबाई से ऊपर हैं या नहीं जिसके नीचे वे काम नहीं आते
ऐसा स्कोर जिसमें त्रुटियाँ सुझावों से भारी हैं
फ़ाइल छोड़िए, या चिपकाइए
जान-बूझकर बिगाड़ा गया उदाहरण, यह देखने के लिए कि क्या पकड़ में आता है
स्किल लिंटर का उपयोग कैसे करें
SKILL.md छोड़िए या उसकी सामग्री चिपकाइए
सबसे गंभीर से शुरू करके टिप्पणियाँ पढ़िए
विवरण उठे तो पहले वही ठीक कीजिए — असल बात वही है
स्कोर साफ़ होने तक दोबारा जाँचते रहिए
उदाहरण
इनपुट
description: Helps with PDFs
आउटपुट
Warning: says what the skill is, but not when to use it
किसी स्किल के कभी न चुने जाने की सबसे आम वजह यही है।
सामान्य त्रुटियाँ और समस्या निवारण
कहता है फ्रंटमैटर नहीं है, जबकि साफ़ दिख रहा है। — तीन हाइफ़न सबसे पहली पंक्ति होने चाहिए: ऊपर न खाली पंक्ति, न टिप्पणी, कुछ भी नहीं।
लंबे विवरण पर YAML टूट जाता है। — जिस विवरण में कोलन के बाद स्पेस हो उसे उद्धरण में रखना पड़ता है, वरना YAML उसे दूसरी कुंजी मान लेता है।
जिस फ़ील्ड को मैं जान-बूझकर रखता हूँ, वही दिखाया जा रहा है। — अनजान फ़ील्ड टिप्पणी के रूप में आते हैं, त्रुटि के रूप में नहीं। लोडर उन्हें छोड़ देता है; टिप्पणी इसलिए है कि ग़लत लिखी कुंजी सही कुंजी जैसी ही दिखती है।
कोई त्रुटि नहीं, फिर भी स्कोर नीचा है। — चेतावनियाँ भी अंक काटती हैं। आम जोड़ी है: ट्रिगर वाक्यांश रहित विवरण और बहुत छोटे निर्देश।
अक्सर पूछे जाने वाले प्रश्न
स्किल लोड तो होती है, चुनी क्यों नहीं जाती?
विवरण को काम से मिलाया जाता है, इसलिए अगर वह सिर्फ़ विषय बताता है — «स्प्रेडशीट के साथ काम करती है» — तो किसी अनुरोध से मिलाने को कुछ बचता ही नहीं। स्थिति, फ़ाइल के प्रकार या लोगों की भाषा नामित करने वाला एक वाक्यांश जोड़ देना आम तौर पर पूरा इलाज है।
ट्रिगर वाक्यांश किसे मानें?
हर वह बात जो लागू होने का क्षण नामित करे: «जब उपयोगकर्ता … माँगे तब», «जब भी माइग्रेशन फ़ाइल बदले», «… से जुड़े कामों के लिए»। लिंटर यही आकार खोजता है और न मिले तो चेतावनी देता है।
क्या लंबा विवरण बुरा है?
अपने आप में नहीं — सीमा उदार है और गिनती दिखती भी है। नुक़सान लंबे उस विवरण से है जो फिर भी कभी नहीं कहता कि स्किल कब इस्तेमाल करनी है; यह जोड़ी हैरान करने की हद तक आम है।
क्या दूसरों की लिखी स्किल जाँच सकते हैं?
यह अच्छा उपयोग है। कहीं और से लाई स्किल छोड़ते ही दिख जाता है कि उसका विवरण आपकी स्किलों से टकराएगा या नहीं और वह कोई अप्रत्याशित उपकरण तो घोषित नहीं करती।
साफ़ नतीजे का मतलब है स्किल काम करेगी?
नहीं। मतलब इतना है कि फ़ाइल लोड होगी और विवरण का आकार वैसा है जैसा मिलाया जाता है। निर्देश अच्छे हैं या नहीं, यह फ़ैसला कोई लिंटर नहीं करता।
संबंधित टूल
स्किल बिल्डर — SKILL.md लिखिए, frontmatter साथ-साथ जाँचा जाता है।
सबएजेंट बिल्डर — सबएजेंट की परिभाषा फ़ाइल बनाइए, उसके उपकरण और मॉडल समेत।