writing-great-skills

# machine-translated to hi from skills/writing-great-skills/SKILL.md — review: pending. Native fixes welcome via PR.name: writing-great-skillsdescription: "एक उच्च-गुणवत्ता Agent Skill (SKILL.md) लिखें जिसे AI भरोसेमंद ढंग से ट्रिगर करे और अच्छी तरह निष्पादित करे — मज़बूत फ़्रंटमैटर, ट्रिगर वाक्यों के साथ तीखा विवरण, स्पष्ट आउटपुट कॉन्ट्रैक्ट, गुणवत्ता जाँच और एंटी-पैटर्न। जब कोई स्किल लिखने, SKILL.md बनाने, स्किल सुधारने, स्किल की गुणवत्ता समीक्षा करने या स्किल लाइब्रेरी में योगदान करने को कहे, तब इसका उपयोग करें। एक पूरी, SkillCheck-पास SKILL.md और मुख्य विकल्पों का संक्षिप्त तर्क तैयार करता है।"

बेहतरीन स्किल लिखने की स्किल

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

ब्रीफ़ से काम करना

एक मोटा विचार ("changelog लिखने की स्किल") मिलने पर पूरी SKILL.md फिर भी बनाएँ — डिलिवरेबल, इनपुट और संरचना का अनुमान लगाएँ, और वास्तव में खुले विकल्पों को चिह्नित करें। <!-- TODO --> छोड़े हुए कंकाल कभी वापस न दें; उन्हें भरें।

आवश्यक इनपुट

माँगें (अगर पहले से न दिए गए हों), वरना अनुमान लगाएँ और लेबल करें:

• स्किल को क्या करना चाहिए और वह ठोस आर्टिफ़ैक्ट जो यह तैयार करती है
• इसे कब ट्रिगर होना चाहिए (वे वाक्य जो उपयोगकर्ता वास्तव में टाइप करेगा)
• उपयोगकर्ता से इसे जो इनपुट चाहिए
• कोई ढाँचा या मानक जिसे यह समाहित करती है (श्रेय के लिए)

बेहतरीन SKILL.md की शारीरिक रचना

1. फ़्रंटमैटर (यही आपकी स्किल को खोजा जाना तय करता है)

---
name: kebab-case-name           # matches the folder; short, specific
description: "<one rich sentence>"
---

विवरण फ़ाइल की सबसे महत्वपूर्ण पंक्ति है — स्किल लोड करनी है या नहीं यह तय करते समय मॉडल सिर्फ़ यही देखता है (प्रगतिशील प्रकटीकरण: किसी एक के लागू होने तक सिर्फ़ नाम + विवरण संदर्भ में होते हैं)। मज़बूत विवरण के तीन भाग होते हैं:

• यह क्या करता है + ठोस डिलिवरेबल।
• एक "Use when …" ट्रिगर खंड जो वास्तविक वाक्य सूचीबद्ध करे ("Use when asked to write a postmortem, do a root-cause analysis, or document an incident")।
• एक "Produces …" खंड जो आउटपुट नामित करे ("Produces a blameless postmortem with timeline, root cause, and action items")।

ट्रिगर वैसे लिखें जैसे उपयोगकर्ता बोलते हैं, न कि जैसे आप स्किल को वर्गीकृत करेंगे। पर्यायवाची कवर करें।

2. एक पंक्ति का मूल्य कथन

मुख्य भाग की शुरुआत वरिष्ठ व्यवसायी की आवाज़ में मूल्य पर एक वाक्य से करें।

3. ब्रीफ़ से काम करना

बताएँ कि स्किल कमज़ोर इनपुट पर भी पूरा आर्टिफ़ैक्ट देती है — धारणाओं का अनुमान लगाएँ और लेबल करें, कोष्ठक वाले प्लेसहोल्डर कभी न छोड़ें, गायब संदर्भ के लिए कभी मना न करें। यही काम करने वाली स्किल को झिकझिक करने वाली से अलग करता है।

4. आवश्यक इनपुट

क्या माँगना है उसकी छोटी सूची — और गायब होने पर लेबल किए अनुमानों के साथ आगे बढ़ने का निर्देश।

5. आउटपुट फ़ॉर्मैट / संरचना

स्किल का हृदय: अंतिम आर्टिफ़ैक्ट का ठोस टेम्पलेट — वास्तविक शीर्षक, तालिकाएँ और खंड। आकार दिखाएँ, अमूर्त वर्णन न करें। ज़्यादातर गुणवत्ता यहीं रहती है।

6. गुणवत्ता जाँच

एक छोटी चेकलिस्ट जिसे आउटपुट को पूरा करना है (वह रूब्रिक जो समीक्षक लागू करेगा)। इन्हें अवलोकन योग्य बनाएँ।

7. एंटी-पैटर्न

बचने योग्य विशिष्ट विफलता तरीके — वे आलसी या सामान्य आउटपुट जो कमज़ोर मॉडल देगा।

प्रक्रिया

1. कुछ और लिखने से पहले डिलिवरेबल को एक वाक्य में तय करें।
2. विवरण लिखें और ट्रिगर पर दबाव डालें ("क्या मॉडल इसे पड़ोसी स्किल के बजाय चुनेगा?")।
3. आउटपुट फ़ॉर्मैट को वास्तविक टेम्पलेट के रूप में ड्राफ़्ट करें।
4. इस स्किल के विशिष्ट विफलता तरीकों को लक्षित करने वाली गुणवत्ता जाँच और एंटी-पैटर्न जोड़ें।
5. सत्यापित करें: npm run skillcheck (संरचना) और इसे कमज़ोर ब्रीफ़ पर चलाकर पुष्टि करें कि यह इनपुट के लिए नहीं गिड़गिड़ाती।

आउटपुट फ़ॉर्मैट

लौटाएँ:

1. पूरी SKILL.md एक फ़ेंस्ड ब्लॉक में, skills/<name>/SKILL.md में सहेजने के लिए तैयार।
2. 3–5 बुलेट का "यह क्यों काम करता है" नोट: चुने गए ट्रिगर वाक्य, डिलिवरेबल, और सबसे तीखा एंटी-पैटर्न जिससे यह बचाता है।

गहरी सामग्री

यह स्किल सहायक फ़ाइलों के साथ आती है — उपलब्ध हों तो उनका उपयोग करें:

• references/description-engineering.md — विवरण इंजीनियरिंग: वे 300 अक्षर जो सब कुछ तय करते हैं। आउटपुट बनाते समय इसे लागू करें; इसमें वह कैलिब्रेशन और निर्णय-विवेक है जिसे ऊपर का संक्षिप्त तरीका संकुचित कर देता है।
• templates/skill-scaffold.md — डिलिवरेबल का भरने योग्य संस्करण, गुणवत्ता-जाँच इनलाइन सहित। जब उपयोगकर्ता दस्तावेज़ खुद बनाना चाहे, उसे जनरेट करवाने के बजाय, तब यह पेश करें।

स्कोरिंग रूब्रिक (0–40)

इस स्किल का कोई भी आउटपुट सौंपने से पहले स्कोर करें; 32+ शिप-गुणवत्ता है।

गुणवत्ता जाँच

• name kebab-case है और इच्छित फ़ोल्डर से मेल खाता है
• विवरण बताता है यह क्या करता है, "Use when …" ट्रिगर खंड है, और यह क्या Produces करता है नामित करता है
• मुख्य भाग में है: मूल्य पंक्ति, ब्रीफ़-से-काम, इनपुट, ठोस आउटपुट फ़ॉर्मैट टेम्पलेट, गुणवत्ता जाँच, एंटी-पैटर्न
• कोई TODO/प्लेसहोल्डर पाठ नहीं बचा
• ट्रिगर पड़ोसी स्किल से अलग हैं (ग़लत फ़ायर या छूटेंगे नहीं)
• npm run skillcheck बिना त्रुटि पास करेगी

एंटी-पैटर्न

• बिना ट्रिगर वाक्यों का धुँधला विवरण — स्किल कभी चुनी नहीं जाती
• ऐसा आउटपुट फ़ॉर्मैट जो आर्टिफ़ैक्ट का टेम्पलेट बनाने के बजाय वर्णन करे
• गुणवत्ता जाँच जो अवलोकन योग्य नहीं ("आउटपुट अच्छा होना चाहिए")
• अंतिम फ़ाइल में <!-- TODO --> या [कोष्ठक वाले] प्लेसहोल्डर छोड़ना
• किसी मौजूदा स्किल से इतना ओवरलैप कि मॉडल दोनों में चुन न सके

उदाहरण ट्रिगर वाक्य

• "एक स्किल लिखो।"
• "एक SKILL.md बनाओ।"
• "एक स्किल सुधारो।"
• "एक स्किल की गुणवत्ता समीक्षा करो।"

इस स्किल को अपने ब्राउज़र में चलाएँ: https://mohitagw15856.github.io/pm-claude-skills/skill/writing-great-skills.html