Skills: SKILL.md
इस section को पढ़ने के बाद, आप एक SKILL.md लिख सकेंगे, और अपने Agent को ज़रूरत पड़ने पर इसे automatically load करवा सकेंगे। हम "weekly report लिखना" skill को practically एक बार चलाकर देखेंगे।
Skill क्या है
Tools बताते हैं "क्या किया जा सकता है" (files पढ़ना, commands चलाना), skills बताते हैं "यह काम कैसे किया जाना चाहिए"।
यह उस operation manual जैसा है जो company एक नए employee को देती है: weekly report में कौन-कौन से subheadings हों, कुछ भी बनाया न जाए, किस filename में save हो…… ये abilities नहीं हैं, ये तरीके हैं। तरीकों को एक file में लिख दें, और Agent ज़रूरत पड़ने पर पढ़कर सीख जाएगा।
Agent Skills ठीक ऐसा ही एक format है: एक skill एक फ़ोल्डर है, जिसके अंदर एक SKILL.md होता है (शुरुआत में YAML metadata का एक हिस्सा, उसके बाद Markdown में लिखे steps), और साथ में scripts, reference materials आदि भी हो सकते हैं।
इतिहास: Anthropic ने साल 2025, महीना 10, तारीख़ 16 को Skills release किए, और साल 2025, महीना 12, तारीख़ 18 को Agent Skills को open standard के रूप में agentskills.io पर publish किया। साल 2026, महीना 11, तारीख़ 4 को, प्रोजेक्ट ने governance document pass किया, जिसके अनुसार यह Linux Foundation के तहत एक प्रोजेक्ट के रूप में स्थापित होगा, license Apache-2.0।
एक SKILL.md लिखें
हमारी "weekly report लिखना" skill यहाँ रखी है skills/weekly-report/SKILL.md:
---
name: weekly-report
description: एक फ़ोल्डर के work records को एक weekly report में organize करें
---
# Weekly report लिखें
1. list_dir से देखें कि दिए गए फ़ोल्डर में कौन-कौन सी record files हैं, और read_file से एक-एक करके पढ़ें।
2. "इस हफ़्ते पूरा हुआ / चल रहा है / अगले हफ़्ते की योजना / सहायता चाहिए" इन चार subheadings के अंतर्गत organize करें, हर point एक वाक्य में, और लिखें कि किस दिन की बात है।
3. records में जो नहीं है उसे बनाकर न लिखें; records में जिन subheadings के लिए कुछ नहीं लिखा है वहाँ "कोई नहीं" लिखें।
4. write_file से परिणाम को 周报.md में लिखें, लिखने से पहले पूरा text user को एक बार दिखाएँ।Specification में दो required fields हैं:
| Field | Requirement |
|---|---|
name | 64 characters से अधिक नहीं, केवल lowercase letters, digits और hyphens, जिस फ़ोल्डर में है उसी के नाम के समान होना चाहिए |
description | 1 से 1024 characters, जिसमें "क्या करता है" और "कब use करें" साफ़ लिखा हो |
Optional fields में license, compatibility, metadata, और experimental allowed-tools शामिल हैं।
प्रगतिशील प्रकटीकरण: सब कुछ एक बार में पढ़ने की ज़रूरत नहीं
अगर दर्जनों skills हों, तो सबको prompt में ठूँसना बहुत बर्बादी है। specification का तरीका तीन स्तरों में बँटा है:
- शुरुआत में केवल metadata पढ़ें: हर skill का name और description, लगभग 100 token;
- ज़रूरत पड़ने पर ही मुख्य सामग्री पढ़ें: पूरा SKILL.md, अनुशंसित 5000 token से कम और 500 लाइनों के भीतर;
- ज़रूरत होने पर ही resources पढ़ें: साथ दी गई scripts और reference files.
अपने Agent को skills के लिए सक्षम बनाएँ
specification की वेबसाइट पर "अपने Agent में Skills सपोर्ट जोड़ें" नाम का एक विशेष लेख है। कोर में सिर्फ़ दो काम हैं: skills डायरेक्टरी को system prompt में डालें, skill पढ़ने का एक तरीका दें। हमारा implementation:
def load_skills():
skills = {}
for f in sorted((HERE / "skills").glob("*/SKILL.md")):
meta = dict(re.findall(r"^(\w+):\s*(.+)$", f.read_text(encoding="utf-8").split("---")[1], re.M))
skills[meta["name"]] = (meta["description"], f)
return skills
SKILLS = load_skills()
def load_skill(name): # 用到时才把完整说明读进来(渐进式披露)
return SKILLS[name][1].read_text(encoding="utf-8") if name in SKILLS else f"没有叫 {name} 的技能"
SYSTEM = ("……\n可用技能(需要时先 load_skill):\n"
+ "\n".join(f"- {n}:{d}" for n, (d, _) in SKILLS.items()))फिर load_skill को tools की सूची में जोड़ें। specification दो सुझाव भी देता है: tool का name पैरामीटर enum बनाना सबसे अच्छा है (केवल मौजूद skill नाम ही allowed), ताकि model ग़ैर-मौजूद skill न बना दे; जब कोई skill न हो, तो खाली डायरेक्टरी न रखें और न ही यह tool रजिस्टर करें। इसके अलावा, .agents/skills/ अलग-अलग clients में साझा skills डायरेक्टरी की convention बनती जा रही है।
चलाकर देखें
python agent.py "用写周报的技能,把 worklog 文件夹整理成周报"हमने qwen3:8b पर वास्तविक रूप से चलाया:
[1] load_skill({"name": "weekly-report"})
[2] read_file({"path": "/worklog/11-16.txt"})
[3] list_dir({"path": "./worklog"})
[4] read_file({"path": "./worklog/11-16.txt"})
[5] read_file({"path": "./worklog/11-18.txt"})
[6] read_file({"path": "./worklog/11-20.txt"})
Agent: साप्ताहिक रिपोर्ट का संकलन परिणाम:
# साप्ताहिक रिपोर्ट
## इस सप्ताह पूर्ण
- सोमवार: Safari पर login page की style गड़बड़ी ठीक की
……
## सहायता चाहिए
- कोई नहीं
सामग्री की पुष्टि के बाद मैं 周报.md फ़ाइल बनाऊँगा।ध्यान दें कि इसने skill में लिखे दो काम किए: चारों उपशीर्षक मौजूद, जो नहीं लिखा था वहाँ "कोई नहीं" लिखा; फ़ाइल लिखने से पहले पूरा text आपको दिखाया। ये सब code से तय नहीं हैं, ये SKILL.md में लिखे हैं।
आपकी परीक्षाकौशल और टूल में क्या अंतर है?
एक बार जाँचें
- मैं SKILL.md के दो required fields और उनकी शर्तें बता सकता/सकती हूँ
- मैं प्रगतिशील प्रकटीकरण के तीन स्तर समझा सकता/सकती हूँ
- मैंने साप्ताहिक रिपोर्ट लिखने वाली skill सफलतापूर्वक चलाई, और अपनी एक skill भी लिखी
अगला अध्याय पारिस्थितिकी तंत्र से जुड़ने के बारे में है: MCP: एक सर्वर लिखें और इसे जोड़ें।