किसी दोहराव वाले काम को अपने AI कोडिंग एजेंट के लिए पुन: उपयोग योग्य स्किल में कैसे बदलें

अगर आप अपने AI कोडिंग एजेंट में वही चेकलिस्ट बार-बार पेस्ट करते रहते हैं — "एक कन्वेंशनल कमिट लिखो, फिर टेस्ट चलाओ, फिर changelog अपडेट करो" — तो आप वह काम कर रहे हैं जिसे एजेंट आपके लिए याद रख सकता था। अधिकांश आधुनिक एजेंट आपको किसी बार-बार आने वाली प्रक्रिया को एक छोटी, पुन: उपयोग योग्य फ़ाइल में पैकेज करने देते हैं। Claude Code में इन्हें स्किल कहा जाता है; यही फ़ाइल /deploy जैसे स्लैश कमांड को भी शक्ति देती है। यह गाइड शुरू से एक स्किल बनाना सिखाती है, फिर उन सिद्धांतों को समझाती है जो दूसरे टूल पर भी लागू होते हैं।

स्किल क्या है

एक स्किल एक फ़ोल्डर है जिसके अंदर एक अकेली SKILL.md फ़ाइल होती है। उस फ़ाइल के दो हिस्से होते हैं: YAML फ्रंटमैटर जो एजेंट को बताता है कि स्किल का उपयोग कब करना है, और एक मार्कडाउन बॉडी जिसमें वे निर्देश होते हैं जिनका वह पालन करता है जब स्किल चलती है। सब कुछ किसी CLAUDE.md (या AGENTS.md) फ़ाइल में ठूँसने की तुलना में इसका मुख्य लाभ है प्रगतिशील प्रकटीकरण (progressive disclosure): बॉडी तभी लोड होती है जब स्किल वास्तव में लागू की जाती है, इसलिए लंबी संदर्भ सामग्री की लागत तब तक लगभग शून्य होती है जब तक आपको इसकी ज़रूरत न हो।

आप किसी स्किल को दो तरीकों से लागू करते हैं: सीधे, /skill-name टाइप करके, या स्वचालित रूप से — एजेंट आपके अनुरोध को पढ़ता है, उसे स्किल के description से मिलाता है, और प्रासंगिक होने पर उसे लोड करता है।

स्किल कहाँ रहती हैं

आप फ़ोल्डर को कहाँ रखते हैं, यह तय करता है कि इसका उपयोग कौन कर सकता है। Claude Code में, आधिकारिक दस्तावेज़ों के अनुसार:

• ~/.claude/skills/<name>/SKILL.md — व्यक्तिगत, आपकी सभी परियोजनाओं में उपलब्ध।
• .claude/skills/<name>/SKILL.md — परियोजना, रिपॉज़िटरी में कमिट की गई ताकि टीम के हर व्यक्ति को वही कमांड मिले।

फ़ोल्डर का नाम ही कमांड बन जाता है। summarize-changes नाम का एक फ़ोल्डर आपको /summarize-changes देता है।

एक ठोस उदाहरण

आइए एक ऐसी स्किल बनाएँ जो आपके बिना-कमिट किए गए बदलावों का सारांश देती है और कमिट करने से पहले किसी भी जोखिम भरी चीज़ को चिह्नित करती है। डायरेक्टरी बनाएँ:

mkdir -p ~/.claude/skills/summarize-changes

फिर इसे ~/.claude/skills/summarize-changes/SKILL.md के रूप में सहेजें:

---
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

## Current changes

!`git diff HEAD`

## Instructions

Summarize the changes above in two or three bullet points, then list any
risks you notice such as missing error handling, hardcoded values, or tests
that need updating. If the diff is empty, say there are no uncommitted changes.

दो चीज़ें इसे काम करने लायक बनाती हैं। पहली, description एजेंट के लिए लिखा गया है, आपके लिए नहीं — यह ट्रिगर्स के नाम बताता है ("what changed," "wants a commit message," "review their diff") ताकि एजेंट जान सके कि इसे कब उपयोग में लाना है। दूसरी, !`git diff HEAD` वाली लाइन डायनेमिक संदर्भ इंजेक्शन है: Claude Code उस कमांड को चलाता है और एजेंट द्वारा स्किल पढ़ने से पहले उसके आउटपुट को प्रॉम्प्ट में पेस्ट कर देता है। निर्देश आपके वास्तविक diff के साथ पहले से इनलाइन होकर आते हैं, इसलिए जवाब अनुमान के बजाय आपके असली वर्किंग ट्री पर आधारित होता है।

किसी भी फ़ाइल में एक छोटा संपादन करें, अपना एजेंट शुरू करें, और इसे दोनों तरीकों से आज़माएँ — इसे स्वचालित रूप से ट्रिगर करने के लिए "what did I change?" पूछें, या इसे सीधे चलाने के लिए /summarize-changes टाइप करें।

आर्गुमेंट पास करना

स्किल इनपुट ले सकती हैं। बॉडी में एक $ARGUMENTS प्लेसहोल्डर को उसी से बदल दिया जाता है जो आप कमांड के बाद टाइप करते हैं, और इंडेक्स किए गए वेरिएंट ($0, $1) विशिष्ट शब्दों को पकड़ते हैं। /fix-issue 4821 के रूप में लागू की गई एक स्किल सीधे इश्यू नंबर का संदर्भ दे सकती है, इसलिए एक ही फ़ाइल हर इश्यू को संभालती है, बजाय हर टिकट के लिए एक-एक के।

टिकाऊ स्किल के लिए पाँच सिद्धांत

ये लागू होते हैं चाहे आप Claude Code स्किल लिख रहे हों, Cursor कमांड, या — OpenAI के जून 2026 के Record & Replay फ़ीचर के अनुसार — किसी ऐसे ऑटोमेशन को संपादित कर रहे हों जिसे एजेंट ने आपके लिए रिकॉर्ड किया था:

1. विवरण मॉडल के लिए लिखें। ठोस ट्रिगर वाक्यांशों को आगे रखें। एक अस्पष्ट विवरण का मतलब है कि एजेंट कभी भी स्किल को स्वतः लोड नहीं करेगा, और आप फिर से / टाइप करने और नाम याद रखने पर वापस आ जाएँगे।
2. हर स्किल को एक ही काम तक सीमित रखें। एक स्किल जो डिप्लॉय और माइग्रेशन चलाती है और Slack पर पोस्ट करती है, उस पर भरोसा करना मुश्किल है और डीबग करना और भी मुश्किल। छोटी, एकल-उद्देश्य वाली स्किल बेहतर तरीके से जुड़ती हैं।
3. संदर्भ का वर्णन करने के बजाय लाइव संदर्भ इंजेक्ट करें। एक असली diff, एक टेस्ट परिणाम, या एक फ़ाइल सूची को खींच लाना, एजेंट को "check the current state" बताने से बेहतर है — यह एक ऐसा चरण हटा देता है जहाँ एजेंट ग़लत अनुमान लगा सकता है।
4. साइड इफ़ेक्ट वाली किसी भी चीज़ को नियंत्रित करें। जो स्किल डिप्लॉय, माइग्रेट, या डिलीट करती हैं, उनके लिए एजेंट को स्वचालित रूप से चलाने देने के बजाय स्पष्ट रूप से लागू करने की आवश्यकता रखें। आप अपरिवर्तनीय कार्रवाइयों से पहले एक मनुष्य को लूप में चाहते हैं।
5. टीम स्किल को रिपॉज़िटरी में कमिट करें। परियोजना स्किल को .claude/skills/ में रखना और उन्हें चेक इन करना मतलब है कि हर डेवलपर — और CI में हर एजेंट रन — वही प्रक्रिया अपनाता है। आपकी परंपराएँ किसी एक व्यक्ति के दिमाग़ में रहना बंद कर देती हैं।

किसी स्किल का सहारा कब लें

अंगूठे का नियम: जिस क्षण आप वही बहु-चरणीय निर्देश तीसरी बार पेस्ट करें, या आपकी CLAUDE.md का कोई हिस्सा किसी तथ्य से किसी प्रक्रिया में बदल जाए, उसे एक स्किल में स्थानांतरित कर दें। आपको एक पुन: उपयोग योग्य कमांड मिलता है, आपकी संदर्भ फ़ाइल दुबली बनी रहती है, और निर्देश तभी लोड होते हैं जब उनकी वास्तव में ज़रूरत हो — जो आपको और एजेंट दोनों को सामने मौजूद काम पर केंद्रित रखता है।