SKILL.md छोटी रखना और ब्योरे References में

Body का भुगतान हर बार होता है

हर बार skill trigger होने पर उसकी पूरी body context में आती है, इसलिए लंबी body आवर्ती लागत है और मुख्य चरण दबा देती है। आम दिशानिर्देश है SKILL.md को लगभग 500 पंक्तियों से कम रखना, मुख्य रास्ता पहले और कम चाहिए ब्योरे संदर्भ files में। अलग files के अच्छे उम्मीदवार: लंबा API दस्तावेज़, बड़े उदाहरण, किनारे के मामलों की सँभाल, database schemas, प्रति-भाषा या प्रति-framework रूप (ताकि Python project Java नोट्स लोड न करे), और जो सिर्फ़ विशिष्ट स्थिति में चाहिए। उपयोगी परीक्षा: किसी अनुच्छेद को हटाने से सामान्य run में Claude का व्यवहार न बदले तो वह माँग पर लोड होने वाली संदर्भ file में होना चाहिए। विषय (पाठक को क्या चाहिए) से बाँटें, मनमाने आकार से नहीं।

क्या कब लोड होता है, चलाकर

मैंने यह सादे Python 3 (सिर्फ़ standard library) से चलाया। 180-पंक्ति की SKILL.md और कुल 1,290 पंक्तियों की तीन संदर्भ या template files: skill trigger होने पर सिर्फ़ 180 पंक्तियाँ लोड होती हैं; बाक़ी 1,290 सिर्फ़ तब पढ़ी जाती हैं जब कार्य को चाहिए। पंक्ति संख्याएँ उदाहरणात्मक हैं।

# Keep SKILL.md focused: long procedures and big reference material belong in separate files loaded on demand.
files = {"SKILL.md": 180, "references/api.md": 900, "references/errors.md": 350, "templates/report.md": 40}
body_limit = 500
for name, lines in files.items():
    flag = "" if name != "SKILL.md" or lines <= body_limit else "  <-- too long, split it"
    print(f"{name:24} {lines:5d} lines{flag}")
print("loaded when the skill triggers :", files["SKILL.md"], "lines (SKILL.md)")
print("loaded only if the task needs it:", sum(v for k, v in files.items() if k != "SKILL.md"), "lines (references/templates)")

Output:

SKILL.md                   180 lines
references/api.md          900 lines
references/errors.md       350 lines
templates/report.md         40 lines
loaded when the skill triggers : 180 lines (SKILL.md)
loaded only if the task needs it: 1290 lines (references/templates)

लंबे references में विषय-सूची जोड़ें

लंबी file के ऊपर छोटी सूची Claude को सही अनुभाग तक पहुँचने में मदद करती है।

त्वरित जाँच: SKILL.md की जगह संदर्भ file में क्या होना चाहिए?

• मुख्य चरण जो हर run को चाहिए
• Skill का name और description
• लंबे, कम चाहिए ब्योरे जैसे पूरे API docs या schemas
• कुछ नहीं