अगर आप बार-बार वही निर्देश Claude Code में पेस्ट करते हैं, तो एक skill उन्हें आपके लिए संभाल सकती है। यह गाइड बताती है कि agent skill क्या है, उसकी फ़ाइलें कहाँ जाती हैं, और एक छोटी skill कैसे लिखें और टेस्ट करें। इसमें प्लगइन मार्केटप्लेस से skills इंस्टॉल करना और वे गलतियाँ भी शामिल हैं जिनकी वजह से कोई skill लोड नहीं होती।
नीचे दी गई हर जानकारी नवंबर 2026 में Anthropic के आधिकारिक डॉक्स से जाँची गई है। Claude Code अक्सर बदलता रहता है, इसलिए लिंक किए गए डॉक्स ही अंतिम स्रोत हैं।
agent skill क्या है
skill एक फ़ोल्डर है जिसके अंदर SKILL.md नाम की फ़ाइल होती है। इस फ़ाइल के दो हिस्से होते हैं। सबसे ऊपर --- मार्करों के बीच YAML frontmatter होता है, जिसमें एक name और एक description होता है। उसके नीचे सामान्य Markdown में निर्देश होते हैं, जिन्हें skill चलने पर Claude फ़ॉलो करता है।
skill फ़ोल्डर में अतिरिक्त फ़ाइलें भी रखी जा सकती हैं, जैसे रेफ़रेंस नोट्स, टेम्पलेट या स्क्रिप्ट।
skills चरणों में लोड होती हैं, जिसे Anthropic progressive disclosure (क्रमिक खुलासा) कहता है। शुरुआत में Claude हर skill का सिर्फ़ नाम और विवरण लोड करता है। पूरे निर्देश तब लोड होते हैं जब skill ट्रिगर होती है, और साथ की फ़ाइलें तभी लोड होती हैं जब Claude उन्हें खोलता है। इसलिए आप context window भरे बिना कई skills इंस्टॉल कर सकते हैं।
आपको क्या चाहिए
- Claude Code इंस्टॉल और साइन-इन किया हुआ
- एक टर्मिनल और एक टेक्स्ट एडिटर
- टेस्ट के लिए एक git प्रोजेक्ट (उदाहरण वाली skill commit messages लिखती है)
स्टेप 1: तय करें कि skill कहाँ रहेगी
आप skill को जहाँ सेव करते हैं, उसी से तय होता है कि कौन-से सेशन उसे देख सकते हैं। सबसे ज़्यादा इस्तेमाल होने वाली दो जगहें हैं:
- पर्सनल:
~/.claude/skills/<skill-name>/SKILL.md। इस मशीन पर आपके सभी प्रोजेक्ट में उपलब्ध। - प्रोजेक्ट: किसी रिपॉज़िटरी के अंदर
.claude/skills/<skill-name>/SKILL.md। उस repo के सेशन में उपलब्ध। इसे commit करें, तो आपकी टीम को भी मिल जाएगी।
इनके अलावा enterprise, nested और plugin लोकेशन भी होती हैं। अगर किसी पर्सनल और प्रोजेक्ट skill का नाम एक जैसा हो, तो पर्सनल skill को प्राथमिकता मिलती है।
एक बात ध्यान रखें: ~/.claude/skills/ में रखी पर्सनल skills को cloud सेशन या Cowork नहीं पढ़ते। उनके लिए डॉक्स कहते हैं कि skill को अपने claude.ai अकाउंट पर चालू करें या उसे रिपॉज़िटरी में commit करें।
स्टेप 2: फ़ोल्डर बनाएँ
हम commit-message नाम की एक पर्सनल skill बनाएँगे।
mkdir -p ~/.claude/skills/commit-message
अपेक्षित नतीजा: कमांड कुछ भी प्रिंट नहीं करती। अब खाली फ़ोल्डर बन गया है।
स्टेप 3: SKILL.md लिखें
~/.claude/skills/commit-message/SKILL.md बनाएँ और उसमें यह पेस्ट करें। फ़ाइल का नाम ठीक SKILL.md ही होना चाहिए।
---
name: commit-message
description: Writes a clear git commit message from the staged changes. Use when the user asks for a commit message, wants to commit their work, or asks how to describe their changes.
---
# Commit message writer
1. Run `git diff --staged` to see what is staged.
2. If nothing is staged, say so and stop.
3. Write a subject line in the imperative mood, under 72 characters.
4. Leave one blank line, then add a short body that explains why the change was made.
5. Show the message in a code block. Do not run `git commit` unless the user asks.
frontmatter के बारे में कुछ बातें:
nameवही कमांड बन जाता है जो आप टाइप करते हैं। अगर आप इसे छोड़ दें, तो Claude Code फ़ोल्डर का नाम इस्तेमाल करता है।descriptionको पढ़कर ही Claude तय करता है कि skill इस्तेमाल करनी है या नहीं। पहले बताएँ कि skill क्या करती है, फिर यह कि उसे कब इस्तेमाल करना है।- शुरुआती
---फ़ाइल की बिल्कुल पहली लाइन होनी चाहिए। वरना Claude Code पूरी फ़ाइल को सामान्य कंटेंट मान लेता है।
Claude Code और भी फ़ील्ड स्वीकार करता है, जैसे disable-model-invocation और allowed-tools। लेकिन claude.ai अपलोड और Skills API सिर्फ़ छह फ़ील्ड स्वीकार करते हैं: name, description, license, compatibility, metadata और allowed-tools। सिर्फ़ name और description रखने से आपकी skill हर जगह चल पाती है।
स्टेप 4: इसे टेस्ट करें
किसी भी git प्रोजेक्ट में एक छोटा बदलाव stage करें, फिर Claude Code शुरू करें।
git add .
claude
आप skill को दो तरह से ट्रिगर कर सकते हैं। पहला, सीधे शब्दों में पूछें और Claude को description से उसे पहचानने दें:
Can you write a commit message for what I've staged?
या उसे सीधे नाम से चलाएँ:
/commit-message
अपेक्षित नतीजा: Claude git diff --staged चलाता है और एक code block में subject line और छोटी body के साथ जवाब देता है।
बदलाव करने के बाद रीस्टार्ट की ज़रूरत नहीं है। Claude Code ~/.claude/skills/ और प्रोजेक्ट की .claude/skills/ पर नज़र रखता है, और मौजूदा सेशन में ही बदलाव ले लेता है।
स्टेप 5: सहायक फ़ाइलें जोड़ें (वैकल्पिक)
जैसे-जैसे skill बड़ी होती है, विस्तार वाली जानकारी SKILL.md से बाहर ले जाएँ। डॉक्स इसे 500 लाइनों से कम रखने की सलाह देते हैं। एक लेआउट कुछ ऐसा हो सकता है:
commit-message/
├── SKILL.md
├── examples.md
└── scripts/
└── check-length.sh
अतिरिक्त फ़ाइलों को SKILL.md से लिंक करें ताकि Claude को पता रहे कि उन्हें कब खोलना है। स्क्रिप्ट चलाई जाती हैं, context में लोड नहीं होतीं।
स्टेप 6: प्लगइन मार्केटप्लेस से skills इंस्टॉल करें
हर skill आपको खुद लिखने की ज़रूरत नहीं है। Claude Code में skills प्लगइन के साथ आ सकती हैं, और प्लगइन मार्केटप्लेस से आते हैं। Anthropic का आधिकारिक मार्केटप्लेस, claude-plugins-official, पहली बार इंटरैक्टिव सेशन शुरू करने पर अपने-आप जुड़ जाता है।
GitHub पर Anthropic की सार्वजनिक skills रिपॉज़िटरी को भी मार्केटप्लेस के तौर पर जोड़ा जा सकता है। उसकी README में ये कमांड दी गई हैं:
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
सेशन में /plugin install प्लगइन पैनल खोलता है, ताकि इंस्टॉल से पहले आप प्लगइन देख सकें और scope चुन सकें। प्लगइन skills namespaced होती हैं, यानी my-plugin नाम के प्लगइन में review नाम की skill /my-plugin:review के रूप में चलती है।
Skills बनाम MCP सर्वर बनाम CLAUDE.md
CLAUDE.md में स्थायी तथ्य और नियम होते हैं जो हर सेशन में लोड होते हैं, जैसे “use pnpm” (pnpm इस्तेमाल करें) या “tests live in tests/” (टेस्ट tests/ में हैं)। इसे छोटा रखें, क्योंकि यह हमेशा context में रहता है।
Skills में ऐसी प्रक्रियाएँ और रेफ़रेंस सामग्री होती है जो सिर्फ़ कभी-कभी काम आती है। Anthropic की सलाह है कि skill तब बनाएँ जब CLAUDE.md का कोई हिस्सा बढ़कर पूरी प्रक्रिया बन जाए, या जब आप बार-बार वही चेकलिस्ट चैट में पेस्ट कर रहे हों।
MCP सर्वर Claude को बाहरी टूल और डेटा से जोड़ते हैं, जैसे कोई डेटाबेस, issue tracker या डिज़ाइन ऐप। skill Claude को बता सकती है कि उन टूल्स का अच्छा इस्तेमाल कैसे करे, लेकिन वह कनेक्शन नहीं देती।
Claude Code के बाहर skills
यही फ़ॉर्मेट Claude के सभी प्रोडक्ट्स में काम करता है। Anthropic के overview के मुताबिक, कस्टम skills Claude Code में बनाई जा सकती हैं, Claude API से अपलोड की जा सकती हैं, या claude.ai सेटिंग्स में जोड़ी जा सकती हैं। claude.ai पर अपलोड की गई skills को API पर अलग से अपलोड करना पड़ता है।
सुरक्षा पर एक बात
skill सिर्फ़ टेक्स्ट नहीं है। इसमें स्क्रिप्ट हो सकती हैं, और यह Claude को कमांड चलाने और टूल कॉल करने की ओर ले जा सकती है। Anthropic की सलाह है कि skills सिर्फ़ भरोसेमंद स्रोतों से ही इस्तेमाल करें, यानी जो आपने खुद लिखी हों या Anthropic से मिली हों। अगर आप कहीं और की skill आज़माते हैं, तो पहले हर फ़ाइल पढ़ें, स्क्रिप्ट भी, और अनचाहे नेटवर्क कॉल या फ़ाइल एक्सेस पर नज़र रखें।
आम गलतियाँ और उनके हल
Claude अपने-आप कभी skill इस्तेमाल नहीं करता
आम वजह होती है अस्पष्ट description। “Helps with git” (git में मदद करती है) से Claude को मिलान के लिए बहुत कम मिलता है। लिखें कि skill क्या करती है और लोग असल में कौन-से शब्द बोलेंगे। आप Claude से “What skills are available?” (कौन-सी skills उपलब्ध हैं?) पूछकर भी जाँच सकते हैं कि वह लोड हुई या नहीं, और उसे सीधे चलाने के लिए /skill-name इस्तेमाल कर सकते हैं।
skill बिल्कुल दिखाई नहीं देती
पाथ और अक्षरों का case जाँचें। यह ~/.claude/skills/<skill-name>/SKILL.md ही होना चाहिए, यानी फ़ाइल अपने खुद के फ़ोल्डर में हो, skills/ में सीधे खुली न पड़ी हो। डॉक्स उन अक्षरों की सूची भी देते हैं जो नाम में नहीं हो सकते, जैसे <, > या शुरुआत या आख़िर में स्पेस।
frontmatter टूटा हुआ है
अगर YAML पार्स नहीं होता, तो भी Claude Code body लोड कर लेता है, लेकिन metadata खाली रहता है। /skill-name तब भी काम करता है, लेकिन Claude आपके description से मिलान नहीं कर पाता। गलती देखने के लिए Claude Code को claude --debug से शुरू करें, या खराब फ़ाइलें ढूँढने के लिए claude plugin validate ~/.claude/skills चलाएँ।
नाम के फ़ॉर्मेट के नियम
claude.ai और API के लिए name में सिर्फ़ छोटे अक्षर, अंक और हाइफ़न हो सकते हैं, यह 64 अक्षरों या उससे कम का होना चाहिए, और इसमें anthropic या claude शब्द नहीं होने चाहिए। description 1,024 अक्षरों तक का हो सकता है। किसी फ़ोल्डर का नाम synced रखने से भी बचें, क्योंकि Claude Code इसे claude.ai से डाउनलोड हुई skills के लिए रिज़र्व रखता है।
बदलाव लागू नहीं हो रहे
मौजूदा skills में किए गए बदलाव बिना रीस्टार्ट के लोड हो जाते हैं। लेकिन अगर आपने कोई ऐसी top-level skills डायरेक्टरी बनाई जो सेशन शुरू होते समय मौजूद नहीं थी, तो /reload-skills चलाएँ। नए प्लगइन के लिए /reload-plugins चलाएँ या Claude Code रीस्टार्ट करें।
skill बहुत ज़्यादा बार चल जाती है
description को और सटीक बनाएँ। अगर आप इसे हमेशा सिर्फ़ खुद ही चलाना चाहते हैं, तो frontmatter में disable-model-invocation: true जोड़ दें।
आख़िर में
skill बस एक फ़ोल्डर, एक SKILL.md फ़ाइल और एक अच्छा description है। हर हफ़्ते दोहराए जाने वाले किसी एक काम से शुरुआत करें, उसके स्टेप लिख लें, और उसे सीधे अनुरोध और /skill-name दोनों से टेस्ट करें। जो भी इंस्टॉल करें, भरोसा करने से पहले उसकी जाँच ज़रूर करें।
Claude पर और जानकारी: हमारी सभी Claude और Anthropic गाइड देखें, काम के हिसाब से समूहित।
स्रोत और आधिकारिक डॉक्स
लिंक आख़िरी बार 15 नवंबर 2026 को जाँचे गए।





प्रतिक्रिया लिखें