Skip to content

mohitagw15856/pm-claude-skills / i18n/hi/skills/writing-great-skills

writing-great-skills

Verified

एक उच्च-गुणवत्ता Agent Skill (SKILL.md) लिखें जिसे AI भरोसेमंद ढंग से ट्रिगर करे और अच्छी तरह निष्पादित करे — मज़बूत फ़्रंटमैटर, ट्रिगर वाक्यों के साथ तीखा विवरण, स्पष्ट आउटपुट कॉन्ट्रैक्ट, गुणवत्ता जाँच और एंटी-पैटर्न। जब कोई स्किल लिखने, SKILL.md बनाने, स्किल सुधारने, स्किल की गुणवत्ता समीक्षा करने या स्किल लाइब्रेरी में योगदान करने को कहे, तब इसका उपयोग करें। एक पूरी, SkillCheck-पास SKILL.md और मुख्य विकल्पों का संक्षिप्त तर्क तैयार करता है।

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

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

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

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

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

## आवश्यक इनपुट

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

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

### 1. फ़्रंटमैटर (यही आपकी स्किल को *खोजा* जाना तय करता है)
```yaml
---
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+ शिप-गुणवत्ता है।

| आयाम | 0 | 5 | 10 |
|---|---|---|---|
| **विवरण और ट्रिगर इंजीनियरिंग** | विवरण बताता है स्किल किस बारे में है, बिना ट्रिगर वाक्यों या नामित डिलिवरेबल के | "Use when…" और "Produces…" हैं, पर ट्रिगर श्रेणी लेबल हैं, उपयोगकर्ता के वास्तविक वाक्य नहीं | तीनों भाग मौजूद; ट्रिगर उपयोगकर्ताओं के वास्तविक पर्यायवाची कवर करते हैं, और इतने अलग हैं कि मॉडल इसे पड़ोसी से न मिलाए |
| **आउटपुट कॉन्ट्रैक्ट की ठोसता** | आउटपुट फ़ॉर्मैट आर्टिफ़ैक्ट का *वर्णन* करता है ("खंडों वाली संरचित रिपोर्ट") | आंशिक टेम्पलेट — कुछ वास्तविक शीर्षक, पर मुख्य खंड अब भी अमूर्त वर्णित | वास्तविक शीर्षकों, तालिकाओं और फ़ील्ड प्रारूपों वाला पूरा टेम्पलेट — दो स्वतंत्र रन पहचाने जाने योग्य रूप से एक जैसा उत्पाद देंगे |
| **गार्डरेल की विशिष्टता** | गुणवत्ता जाँच अवलोकन योग्य नहीं ("आउटपुट स्पष्ट होना चाहिए"); एंटी-पैटर्न गायब या सामान्य | जाँचें अवलोकन योग्य पर किसी भी दस्तावेज़ के लिए सामान्य; एंटी-पैटर्न इस स्किल के विफलता तरीके नामित नहीं करते | हर जाँच एक नज़र में सत्यापन योग्य, और हर एंटी-पैटर्न एक विशिष्ट आलसी आउटपुट नामित करता है जो कमज़ोर मॉडल इस आर्टिफ़ैक्ट के लिए वास्तव में देगा |
| **कमज़ोर-ब्रीफ़ लचीलापन** | स्किल इनपुट के लिए गिड़गिड़ाती है या `[placeholders]` से भरा कंकाल लौटाएगी | ब्रीफ़-से-काम खंड मौजूद, पर अनुमान लेबल करने का निर्देश नहीं, इसलिए कमियाँ चुपचाप गढ़ी जाती हैं | स्पष्ट निर्देश: पूरा आर्टिफ़ैक्ट फिर भी बनाएँ, धारणाओं का अनुमान लगाएँ और *लेबल* करें, कभी TODO न छोड़ें — और इनपुट सूची बताती है कि सिर्फ़ तब पूछें जब वह आउटपुट बदले |

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

- [ ] `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
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 323kUpdated Claude CodeCodexVerifiedInstall