पाठ 2 / 26
Skill की संरचना: Folder, SKILL.md, Frontmatter, Body
SKILL.md file को हिस्सा-हिस्सा पढ़ें।
ऊपर metadata, नीचे निर्देश
Skill एक folder है जिसका नाम skill का नाम है, और जिसमें SKILL.md नाम की file होती है। उस file के दो हिस्से हैं। --- पंक्तियों के बीच frontmatter YAML metadata है: name (छोटे अक्षर, अंक और hyphens, folder से मेल खाता, अधिकतम 64 अक्षर) और description (skill क्या करती है और कब उपयोग करें, अधिकतम 1024 अक्षर)। कुछ skills allowed-tools जैसे वैकल्पिक fields जोड़ती हैं जो उन tools की सूची देते हैं जिन्हें skill अतिरिक्त prompts के बिना उपयोग कर सकती है; अपने संस्करण के समर्थित fields के लिए docs देखें। Body सादा Markdown है: skill कब उपयोग करें, अनुसरण के चरण, उदाहरण और बारीकियाँ। Folder में scripts, संदर्भ दस्तावेज़ और templates भी हो सकते हैं जिनकी ओर निर्देश इशारा करते हैं। चूँकि यह बस पाठ files है, skill की कोड की तरह समीक्षा, diff और version control हो सकता है।
न्यूनतम SKILL.md
सबसे छोटी उपयोगी skill: metadata और छोटी प्रक्रिया। इसे release-notes/SKILL.md नाम से सहेजें।
---
name: release-notes
description: "Draft release notes from merged pull requests since the last tag. Use when asked to write a changelog, release notes or what changed in a release. Triggers on: release notes, changelog, what changed."
---
# release-notes
## Steps
1. Find the latest tag: `git describe --tags --abbrev=0`.
2. List merged PRs since it: `git log <tag>..HEAD --merges --oneline`.
3. Group entries under **Features**, **Fixes** and **Chores**; one line each, user-facing wording.
4. Output Markdown using the template in `templates/notes.md`.
## Gotchas
- Skip dependency-bump PRs unless they fix a security issue.
- Never invent PR numbers; only use what `git log` printed.Frontmatter सरल रखें
सादी key: value पंक्तियाँ और quoted descriptions सबसे भरोसे से parse होते हैं। Tabs और अजीब YAML से बचें।
त्वरित जाँच: हर skill को कौन-से दो frontmatter fields चाहिए?
- name और description
- author और licence
- model और temperature
- port और host
Answer
name और description — Name skill की पहचान है और description बताता है कि कब उपयोग करना है।