mohitagw15856/pm-claude-skills / i18n/hi/skills/writing-great-skills
writing-great-skills
Verifiedएक उच्च-गुणवत्ता 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. एंटी-पैटर्न
बचने योग्य विशिष्ट विफलता तरीके — वे आलसी या सामान्य आउटपुट जो कमज़ोर मॉडल देगा।
प्रक्रिया
- कुछ और लिखने से पहले डिलिवरेबल को एक वाक्य में तय करें।
- विवरण लिखें और ट्रिगर पर दबाव डालें ("क्या मॉडल इसे पड़ोसी स्किल के बजाय चुनेगा?")।
- आउटपुट फ़ॉर्मैट को वास्तविक टेम्पलेट के रूप में ड्राफ़्ट करें।
- इस स्किल के विशिष्ट विफलता तरीकों को लक्षित करने वाली गुणवत्ता जाँच और एंटी-पैटर्न जोड़ें।
- सत्यापित करें:
npm run skillcheck(संरचना) और इसे कमज़ोर ब्रीफ़ पर चलाकर पुष्टि करें कि यह इनपुट के लिए नहीं गिड़गिड़ाती।
आउटपुट फ़ॉर्मैट
लौटाएँ:
- पूरी SKILL.md एक फ़ेंस्ड ब्लॉक में,
skills/<name>/SKILL.mdमें सहेजने के लिए तैयार। - 3–5 बुलेट का "यह क्यों काम करता है" नोट: चुने गए ट्रिगर वाक्य, डिलिवरेबल, और सबसे तीखा एंटी-पैटर्न जिससे यह बचाता है।
गहरी सामग्री
यह स्किल सहायक फ़ाइलों के साथ आती है — उपलब्ध हों तो उनका उपयोग करें:
references/description-engineering.md— विवरण इंजीनियरिंग: वे 300 अक्षर जो सब कुछ तय करते हैं। आउटपुट बनाते समय इसे लागू करें; इसमें वह कैलिब्रेशन और निर्णय-विवेक है जिसे ऊपर का संक्षिप्त तरीका संकुचित कर देता है।templates/skill-scaffold.md— डिलिवरेबल का भरने योग्य संस्करण, गुणवत्ता-जाँच इनलाइन सहित। जब उपयोगकर्ता दस्तावेज़ खुद बनाना चाहे, उसे जनरेट करवाने के बजाय, तब यह पेश करें।
स्कोरिंग रूब्रिक (0–40)
इस स्किल का कोई भी आउटपुट सौंपने से पहले स्कोर करें; 32+ शिप-गुणवत्ता है।
| आयाम | 0 | 5 | 10 |
|---|---|---|---|
| विवरण और ट्रिगर इंजीनियरिंग | विवरण बताता है स्किल किस बारे में है, बिना ट्रिगर वाक्यों या नामित डिलिवरेबल के | "Use when…" और "Produces…" हैं, पर ट्रिगर श्रेणी लेबल हैं, उपयोगकर्ता के वास्तविक वाक्य नहीं | तीनों भाग मौजूद; ट्रिगर उपयोगकर्ताओं के वास्तविक पर्यायवाची कवर करते हैं, और इतने अलग हैं कि मॉडल इसे पड़ोसी से न मिलाए |
| आउटपुट कॉन्ट्रैक्ट की ठोसता | आउटपुट फ़ॉर्मैट आर्टिफ़ैक्ट का वर्णन करता है ("खंडों वाली संरचित रिपोर्ट") | आंशिक टेम्पलेट — कुछ वास्तविक शीर्षक, पर मुख्य खंड अब भी अमूर्त वर्णित | वास्तविक शीर्षकों, तालिकाओं और फ़ील्ड प्रारूपों वाला पूरा टेम्पलेट — दो स्वतंत्र रन पहचाने जाने योग्य रूप से एक जैसा उत्पाद देंगे |
| गार्डरेल की विशिष्टता | गुणवत्ता जाँच अवलोकन योग्य नहीं ("आउटपुट स्पष्ट होना चाहिए"); एंटी-पैटर्न गायब या सामान्य | जाँचें अवलोकन योग्य पर किसी भी दस्तावेज़ के लिए सामान्य; एंटी-पैटर्न इस स्किल के विफलता तरीके नामित नहीं करते | हर जाँच एक नज़र में सत्यापन योग्य, और हर एंटी-पैटर्न एक विशिष्ट आलसी आउटपुट नामित करता है जो कमज़ोर मॉडल इस आर्टिफ़ैक्ट के लिए वास्तव में देगा |
| कमज़ोर-ब्रीफ़ लचीलापन | स्किल इनपुट के लिए गिड़गिड़ाती है या [placeholders] से भरा कंकाल लौटाएगी | ब्रीफ़-से-काम खंड मौजूद, पर अनुमान लेबल करने का निर्देश नहीं, इसलिए कमियाँ चुपचाप गढ़ी जाती हैं | स्पष्ट निर्देश: पूरा आर्टिफ़ैक्ट फिर भी बनाएँ, धारणाओं का अनुमान लगाएँ और लेबल करें, कभी TODO न छोड़ें — और इनपुट सूची बताती है कि सिर्फ़ तब पूछें जब वह आउटपुट बदले |
गुणवत्ता जाँच
-
namekebab-case है और इच्छित फ़ोल्डर से मेल खाता है - विवरण बताता है यह क्या करता है, "Use when …" ट्रिगर खंड है, और यह क्या Produces करता है नामित करता है
- मुख्य भाग में है: मूल्य पंक्ति, ब्रीफ़-से-काम, इनपुट, ठोस आउटपुट फ़ॉर्मैट टेम्पलेट, गुणवत्ता जाँच, एंटी-पैटर्न
- कोई
TODO/प्लेसहोल्डर पाठ नहीं बचा - ट्रिगर पड़ोसी स्किल से अलग हैं (ग़लत फ़ायर या छूटेंगे नहीं)
-
npm run skillcheckबिना त्रुटि पास करेगी
एंटी-पैटर्न
- बिना ट्रिगर वाक्यों का धुँधला विवरण — स्किल कभी चुनी नहीं जाती
- ऐसा आउटपुट फ़ॉर्मैट जो आर्टिफ़ैक्ट का टेम्पलेट बनाने के बजाय वर्णन करे
- गुणवत्ता जाँच जो अवलोकन योग्य नहीं ("आउटपुट अच्छा होना चाहिए")
- अंतिम फ़ाइल में
<!-- TODO -->या[कोष्ठक वाले]प्लेसहोल्डर छोड़ना - किसी मौजूदा स्किल से इतना ओवरलैप कि मॉडल दोनों में चुन न सके
उदाहरण ट्रिगर वाक्य
- "एक स्किल लिखो।"
- "एक SKILL.md बनाओ।"
- "एक स्किल सुधारो।"
- "एक स्किल की गुणवत्ता समीक्षा करो।"
इस स्किल को अपने ब्राउज़र में चलाएँ: https://mohitagw15856.github.io/pm-claude-skills/skill/writing-great-skills.html
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |