स्किल एक फ़ोल्डर है जिसके भीतर SKILL.md होती है: एक छोटा YAML शीर्ष और Markdown में लिखे निर्देश। समय निर्देशों पर लगता है, पर वे निर्देश कभी पढ़े जाएँगे या नहीं, यह विवरण तय करता है। विवरण को सामने खड़े काम से मिलाया जाता है, इसलिए जो विवरण यह तो बताता है कि स्किल किस बारे में है पर यह कभी नहीं कि उसे कब उठाना है, वह अनिश्चित काल तक बिना इस्तेमाल पड़ा रहेगा — और कोई त्रुटि यह बताने नहीं आएगी कि क्यों। यह बिल्डर फ़ाइल लिखता है और उसी एक फ़ील्ड को सबसे कड़ाई से देखता है: क्या उसमें कोई ट्रिगर नामित है, क्या वह मिलान के लिए पर्याप्त लंबा है, और क्या उसके शुरुआती शब्द व्यर्थ चले गए हैं। नाम फ़ोल्डर के नियमों से जाँचा जाता है, और निर्देश उस लंबाई से जिसके नीचे वे शायद ही कुछ बदलते हैं।
विशेषताएँ
नाम फ़ोल्डर नियमों से जाँचा जाता है, सुधरा हुआ रूप भी सुझाया जाता है
विवरण में ट्रिगर वाक्यांश की जाँच — मिलान असल में वही कराता है
विवरण इतना छोटा हो कि संकेत ही न रहे तो चेतावनी
वैकल्पिक अनुमत उपकरण सूची, टाइप करने के बजाय चुनकर
ऐसा स्कोर जो रोकने वाली त्रुटियों को सुझावों से अलग रखे
फ़ाइल जहाँ रखनी है उसका सटीक पथ
फ्रंटमैटर सही ढंग से उद्धृत, ताकि कोलन मान को न तोड़े
SKILL.md के रूप में सीधे डाउनलोड
स्किल बिल्डर का उपयोग कैसे करें
स्किल का नाम छोटे अक्षरों और हाइफ़न में रखिए
ऐसा विवरण लिखिए जो यह भी बताए कि क्या करती है और यह भी कि कब
निर्देश Markdown में लिखिए
टिप्पणियाँ पढ़िए और SKILL.md डाउनलोड कीजिए
उदाहरण
इनपुट
name: release-notes
आउटपुट
description: Writes release notes from a range of git commits. Use when the user asks for a changelog.
«जब … हो तब इस्तेमाल कीजिए» यही वाक्यांश विषय को ट्रिगर बनाता है।
सामान्य त्रुटियाँ और समस्या निवारण
स्किल कभी इस्तेमाल होती ही नहीं दिखती। — लगभग हमेशा विवरण। उसे यह कहना चाहिए कि वह कब लागू होती है, उन्हीं शब्दों में जो लोग सचमुच बोलते हैं: फ़ाइल के प्रकार, काम के नाम, वे वाक्यांश जो कोई टाइप करेगा।
नाम अस्वीकार हो गया। — यह फ़ोल्डर का नाम भी है, इसलिए केवल छोटे अक्षर, अंक और इकहरे हाइफ़न चलेंगे। आपका न बैठे तो सुधरा हुआ रूप सुझा दिया जाता है।
विवरण में कोलन है और फ़ाइल टूट जाती है। — ऐसा नहीं होना चाहिए — ज़रूरत पड़ने पर मान उद्धरण में रख दिए जाते हैं। बाद में हाथ से संपादित करें तो कोलन और स्पेस वाले हर मान को उद्धरण में रखिए।
स्किल लोड होती है पर कुछ बदलती नहीं। — बहुत छोटे निर्देश शायद ही व्यवहार हिलाते हैं। बताइए क्या बनाना है, कैसे काम करना है, और क्या नहीं करना है।
अक्सर पूछे जाने वाले प्रश्न
अच्छा स्किल विवरण किसे कहेंगे?
वह एक-दो वाक्यों में दो सवालों का जवाब देता है: स्किल क्या करती है, और उसे कब इस्तेमाल करना है। मिलान दूसरे हिस्से से होता है, इसलिए फ़ाइल के प्रकार, काम और वह भाषा बताइए जो लोग सचमुच बोलते हैं। «दस्तावेज़ों में मदद करती है» किसी ख़ास चीज़ से नहीं मिलता।
फ़ाइल कहाँ जाती है?
स्किल के नाम वाले फ़ोल्डर में, skills निर्देशिका के भीतर। पथ संपादक के नीचे दिखता है और नाम टाइप करते ही बदलता रहता है। फ़ोल्डर का नाम और name फ़ील्ड एक जैसे होने चाहिए।
क्या अनुमत उपकरणों की सूची देनी चाहिए?
तभी जब स्किल को सत्र के मुक़ाबले सचमुच कम उपकरण चाहिए। खाली छोड़ने का अर्थ है जो उपलब्ध है वही मिल जाना, और आमतौर पर यही ठीक रहता है; सीमित करना एक केंद्रित स्किल को केंद्रित बनाए रखने का तरीक़ा है।
निर्देश कितने लंबे हों?
इतने कि वे ठोस रहें, उससे ज़्यादा नहीं। कुछ वाक्य शायद ही व्यवहार बदलते हैं; कई पन्ने सरसरी तौर पर पढ़े जाते हैं। शीर्षकों वाले खंड एक लंबे ब्लॉक से बेहतर टिकते हैं।
क्या फ़ाइल कहीं और जाँची जाती है?
लोडर कमज़ोर विवरण वाली फ़ाइल भी सहज ही स्वीकार कर लेता है — समस्या ठीक यही है। बाद में कुछ भी आपको नहीं बताता कि यह स्किल मिलाई ही नहीं जा सकती, इसीलिए जाँच पहले ही बनती है।
संबंधित टूल
स्किल लिंटर — SKILL.md चिपकाइए और देखिए उसे किसी काम से जुड़ने से क्या रोक रहा है।
सबएजेंट बिल्डर — सबएजेंट की परिभाषा फ़ाइल बनाइए, उसके उपकरण और मॉडल समेत।