पाठ 5 / 25

Skill की बनावट

नाम, विवरण और चरण-दर-चरण निर्देशों वाली SKILL.md फ़ाइल पढ़ें और लिखें।

SKILL.md वाला folder

Skill एक folder है जिसकी मुख्य फ़ाइल SKILL.md YAML frontmatter से शुरू होती है जिसमें name और description होते हैं, फिर Markdown निर्देश। Folder में scripts, templates और संदर्भ दस्तावेज़ भी हो सकते हैं जिनकी ओर निर्देश इशारा करते हैं।

छोटा folder, ज़रूरत पर लोड

Skill निर्देशों और सहायक files को पैक करता है। Agent पहले छोटा विवरण देखता है और बाक़ी सिर्फ़ ज़रूरत पर लोड करता है।

तीन परतें: विवरण, निर्देश, संसाधन।
चित्र 2.1 — विवरण, निर्देश और संसाधन।

एक छोटी SKILL.md

Description agent को बताता है कि skill कब उपयोग करना है। Body प्रक्रिया है। Claude Code में project skills .claude/skills/<name>/SKILL.md में रहते हैं।

---
name: release-notes
description: Write release notes from merged pull requests. Use when the user asks for a changelog or release summary.
---

# Release notes

1. List merged PRs since the last tag with `git log`.
2. Group them under Features, Fixes and Chores.
3. Write one plain-language line per PR.
4. Save the result to `RELEASE_NOTES.md`.

एक skill, एक काम

हर skill को एक दोहराए जाने वाले काम पर केंद्रित रखें। जो skill reviews, deployments और docs सब कवर करना चाहे वह ग़लत समय पर चलता है और सँभालना कठिन होता है।

त्वरित जाँच: SKILL.md का कौन-सा हिस्सा agent को बताता है कि skill कब उपयोग करना है?

  • फ़ाइल की आख़िरी पंक्ति
  • Folder का आकार
  • फ़ाइल extension
  • Frontmatter का description
Answer

Frontmatter का description — Agent इसी description को पढ़कर तय करता है कि skill लागू होता है या नहीं।