Claude Code में Skills प्रबंधन: संदर्भ बजट को बढ़ाए बिना आवश्यक क्षमताएं कैसे बनाए रखें

Skills सत्र की शुरुआती विंडो को कैसे प्रभावित करते हैं

Claude Code में स्किल्स संरचित डायरेक्टरी और Markdown दस्तावेज़ (मुख्य रूप से SKILL.md) होते हैं, जिन्हें एजेंट अपनी क्षमताओं का विस्तार करने के लिए पढ़ता है। जब कोई सत्र शुरू होता है, तो एजेंट उपलब्ध स्किल्स के नाम और संक्षिप्त विवरण को स्कैन करता है ताकि उसे पता रहे कि किन विशेष कार्यों के लिए कौन से टूल्स उपलब्ध हैं।

किसी स्किल का संदर्भ खर्च तीन अलग-अलग स्तरों में विभाजित होता है:

1. सिस्टम घोषणा (विवरण और ट्रिगर): SKILL.md के frontmatter में दिया गया name और description। यह सक्रिय मेमोरी में रहता है ताकि एजेंट उपयोगकर्ता के अनुरोध को सही टूल से जोड़ सके।
2. मुख्य निर्देश सामग्री: विस्तृत चरण, नियम और कोड उदाहरण। मॉडल इस सामग्री को केवल तभी लोड करता है जब संबंधित स्किल ट्रिगर होता है।
3. सहायक स्क्रिप्ट और संदर्भ: scripts/ में निष्पादन योग्य फाइलें या references/ में दस्तावेज़, जिन्हें CLI कमांड के माध्यम से सटीक रूप से चलाया जाता है।

एक सामान्य गलती यह है कि डेवलपर्स पूरे API मैनुअल या विस्तृत स्टाइल गाइड को सीधे description या मुख्य CLAUDE.md फ़ाइल में रख देते हैं। इससे हर बातचीत में अनावश्यक टोकन खर्च होते हैं।

जब आप BetterToken जैसे बाहरी प्लेटफ़ॉर्म के माध्यम से API कनेक्शन कॉन्फ़िगर करते हैं, तो उपयोग डैशबोर्ड (Dashboard) प्रत्येक कॉल में input, output और cache tokens की स्पष्ट जानकारी प्रदान करता है। हालांकि, सर्वर-साइड मॉनिटरिंग केवल भेजे गए डेटा को मापती है; यह स्थानीय कॉन्फ़िगरेशन फ़ाइलों के आंतरिक ऑडिट का विकल्प नहीं है। आप BetterToken Docs में विस्तृत एंडपॉइंट और सेटअप विवरण देख सकते हैं।

उपयोग की आवृत्ति के आधार पर Skills की सूची बनाना

अपने वर्कस्पेस को व्यवस्थित करने के लिए, अपने प्रोजेक्ट और यूज़र कॉन्फ़िगरेशन (~/.claude/skills/) में मौजूद सभी सक्रिय स्किल्स की सूची बनाएं।

उन्हें उपयोग की वास्तविक आवृत्ति के आधार पर वर्गीकृत करें:

सामान्य नियम के रूप में, यदि किसी निर्देश की आवश्यकता दस में से केवल एक सत्र में होती है, तो उसे स्थायी मेमोरी में नहीं रखा जाना चाहिए।

मुख्य नियमों और ऑन-डिमांड संसाधनों को अलग करना

शुरुआती टोकन भार को कम करने के लिए, प्रत्येक स्किल को एक संक्षिप्त प्रवेश बिंदु और निष्पादन योग्य स्क्रिप्ट के साथ संरचित करें।

1. YAML Frontmatter को अनुकूलित करें

description फ़ील्ड में अनावश्यक विवरण के बिना स्पष्ट ट्रिगर शर्तें लिखें:

---
name: db-migrator
description: >-
  स्कीमा परिवर्तन होने पर Prisma डेटाबेस माइग्रेशन को सत्यापित और लागू करने के लिए उपयोग करें।
---

हेडर में कोड के बड़े ब्लॉक शामिल करने से बचें। विस्तृत स्कीमा और तालिकाओं को references/ सबडायरेक्टरी में ले जाएं।

2. जटिल लॉजिक को स्क्रिप्ट में स्थानांतरित करें

मॉडल से लंबे टेक्स्ट विवरण के आधार पर जटिल कमांड बनाने के लिए कहने के बजाय, लॉजिक को निष्पादन योग्य स्क्रिप्ट में रखें:

<!-- SKILL.md के अंदर -->
स्कीमा अखंडता को सत्यापित करने के लिए, निम्न कमांड चलाएं:
```bash
python3 scripts/validate_schema.py --strict

यह `SKILL.md` के टेक्स्ट आकार को काफी कम करता है और लगातार सटीक परिणाम सुनिश्चित करता है। टोकन बचाने के लिए कभी भी सुरक्षा लिंटर्स या टाइप चेकर्स को अक्षम न करें; निश्चित सत्यापन हमेशा सक्रिय रहना चाहिए।

टूल पहचान और निष्पादन का परीक्षण

स्किल्स को पुनर्गठित करने के बाद, जांचें कि मॉडल सही समय पर निर्देशों को सही ढंग से पहचान रहा है या नहीं।

चरण 1: सिंटैक्स और पथ की जाँच करें

सुनिश्चित करें कि सभी SKILL.md फ़ाइलों में मान्य YAML है और स्क्रिप्ट के पथ सही हैं:

# स्किल फ़ाइल और स्क्रिप्ट अनुमतियों की पुष्टि करें
test -f .claude/skills/db-migrator/SKILL.md && echo "SKILL.md OK"
test -x .claude/skills/db-migrator/scripts/validate_schema.py && echo "Script executable OK"

चरण 2: नए सत्र में ट्रिगर का परीक्षण करें

एक नया सत्र शुरू करें और स्किल का नाम लिए बिना कार्य से संबंधित प्रश्न पूछें:

"कृपया Prisma स्कीमा में User मॉडल को अपडेट करें और माइग्रेशन की पुष्टि करें।"

एजेंट को निम्नलिखित करना चाहिए:

1. db-migrator के विवरण से कार्य की पहचान करना।
2. SKILL.md के मुख्य निर्देशों को लोड करना।
3. तैयार सत्यापन स्क्रिप्ट चलाने का सुझाव देना।

चरण 3: शुरुआती संदर्भ स्थिति का मूल्यांकन करें

सत्र के प्रवाह का निरीक्षण करें। इस ऑडिट का उद्देश्य अनावश्यक शोर को हटाकर वास्तविक संवाद के लिए संदर्भ क्षमता को सुरक्षित रखना है, न कि केवल एक संख्यात्मक प्रतिशत का पीछा करना। केवल उन्हीं स्किल्स को सक्रिय रखें जो वर्तमान विकास कार्यों के लिए आवश्यक हैं।