SSD Nodes Learn Hosting plans →
मार्गदर्शक Matt Connorद्वारे Matt Connor

स्वतःचे agent skill कसे लिहावे?

प्रत्यक्ष अपयशातून agent skill तयार करा: SKILL.md ची रचना, सक्रियता ठरवणारी description ओळ आणि पुन्हा तोच प्रश्न विचारून चाचणी कशी घ्यावी ते जाणून घ्या.

एका प्रत्यक्ष अपयशातून स्वतःचे agent skill लिहा

स्वतःचे agent skill लिहिण्याचा सर्वोत्तम मार्ग म्हणजे ते एका प्रत्यक्ष अपयशातून तयार करणे. तुमच्या coding agent ने दोनदा चुकीचे केलेले एखादे काम शोधा, दोन्ही वेळा तुम्ही टाइप केलेली दुरुस्ती लिहून ठेवा आणि ती दुरुस्ती agent स्वतः लोड करू शकेल अशा SKILL.md फाइलमध्ये जतन करा. त्यानंतरची सर्व प्रक्रिया तांत्रिक आहे: फाइलची मांडणी आणि skill सक्रिय होईल की नाही हे ठरवणारी एक ओळ.

हा क्रम महत्त्वाचा आहे. कल्पनेतून लिहिलेला skill तुम्हाला कधीच आलेली नसलेली समस्या नोंदवतो आणि प्रत्येक session मध्ये context वापरतो. प्रत्यक्ष पाहिलेल्या अपयशातून तयार केलेल्या skill सोबत त्याची चाचणीही तयार असते: पुन्हा तोच प्रश्न विचारा आणि यावेळी agent योग्य उत्तर देतो का ते तपासा. हा format तुमच्यासाठी नवीन असल्यास, आधी agent skills म्हणजे काय आणि agent ते कसे लोड करतो वाचा. त्यानंतर परत येऊन एक skill लिहा.

एजंटने दोनदा चुकीचे केलेल्या कार्यापासून सुरुवात करा

एकदा घडलेली चूक योगायोग असू शकते. दोनदा घडलेली चूक एक नमुना दर्शवते, आणि असा नमुना फाइलमध्ये नोंदवण्यासारखा असतो.

प्रत्यक्ष सर्व्हरवर वारंवार दिसणारे अपयश असे आहे. तुम्ही एजंटला nginx मध्ये reverse proxy block जोडण्यास सांगता. तो /etc/nginx/conf.d/app.conf संपादित करतो आणि नंतर sudo systemctl restart nginx चालवतो. संपादनात टायपो असल्यामुळे nginx सुरू होण्यास नकार देतो आणि तुम्ही तो दुरुस्त करेपर्यंत साइट बंद राहते:

nginx: [emerg] unknown directive "proxy_pas" in /etc/nginx/conf.d/app.conf:12
Job for nginx.service failed because the control process exited with error code.

तुम्ही chat मध्ये ती चूक दुरुस्त करता. सेवा हाताळण्यापूर्वी sudo nginx -t वापरून configuration तपासा. त्यानंतर restart ऐवजी reload वापरून ते लागू करा. एका आठवड्यानंतर, वेगळ्या कार्यात पुन्हा तीच चूक होते. दुसऱ्यांदा घडलेली ही चूक संकेत आहे.

अपयश समोर असतानाच दोन गोष्टी लिहून ठेवा: तुम्ही टाइप केलेली विनंती आणि तुम्ही दिलेली दुरुस्ती, तुम्ही वापरलेल्या शब्दांत. या दोन ओळी skill बनतात. विनंतीत कोणता trigger जुळला पाहिजे हे स्पष्ट होते. दुरुस्तीमध्ये संपूर्ण आशय असतो.

Anthropic च्या स्वतःच्या authoring guidance मध्येही यालाच प्रथम स्थान दिले आहे. कोणतेही skill न वापरता एजंटला प्रतिनिधिक कार्यांवर चालवा, तो कुठे अपयशी ठरतो ते नोंदवा आणि नंतर त्या अपयशांचे निराकरण करणाऱ्या किमान सूचना लिहा. अपयशच specification असते. त्यामुळे एखादे skill कोणत्या अपयशातून आले हे तुम्ही शोधू शकत नसाल, तर ते सहसा कोणालाच आवश्यक नसते. तुम्ही स्वतः लिहिण्याऐवजी install केलेल्या skills साठीही हाच निकष लागू होतो. तसेच Matt Pocock चे 27 plugin skills solo developer ने VPS वर install करावीत अशा skills आणि फक्त team वर उपयोगी ठरणाऱ्या skills यांचे विभाजन करतात. त्याच्या public beta directory मध्ये plugin मधून वगळलेली आणखी सात install करता येणारी skills दिली आहेत.

याच प्रकारच्या distillation चे सविस्तर उदाहरण पाहण्यासाठी Ponytail तुम्ही मागितल्यापेक्षा खूप अधिक मजकूर पुन्हा लिहिणाऱ्या एजंटच्या एका वारंवार होणाऱ्या अपयशाचे skill मध्ये रूपांतर करते हा मजकूर स्वतःचे skill लिहिण्यापूर्वी सुरुवातीपासून शेवटपर्यंत वाचा.

कौशल्याची रचना

कौशल्य ही एक directory असते. त्यात एक आवश्यक file असतो.

.claude/skills/nginx-config-changes/
├── SKILL.md
├── reference/
│   └── proxy-headers.md
└── scripts/
    └── check-and-reload.sh

SKILL.md ची सुरुवात frontmatter block ने होते. --- markers यांच्या मध्ये YAML मध्ये लिहिलेल्या काही settings असतात. Docker Compose files मध्येही हाच configuration format वापरला जातो. त्यानंतर markdown मध्ये instructions असतात. वरील failure साठीचे संपूर्ण कौशल्य येथे दिले आहे.

---
name: nginx-config-changes
description: Tests and reloads nginx safely after a config edit. Use when editing files under /etc/nginx, adding a server block or a reverse proxy, or changing a TLS certificate path.
---

## Rules

Run `sudo nginx -t` after every edit under `/etc/nginx`. Do not touch the service until it prints `test is successful`.

Apply the change with `sudo systemctl reload nginx`. Never use `restart`. A reload keeps the running workers serving traffic until the new config parses, so a broken config leaves the site up. A restart stops nginx first, so a broken config takes the site down.

If `nginx -t` fails, fix the file and test again. Never reload a config that failed the test.

For the proxy header defaults this project expects, see [reference/proxy-headers.md](reference/proxy-headers.md).

ही file वीस lines पेक्षा लहान आहे आणि ती एक पूर्ण कौशल्य आहे. त्याचे भाग:

  • name: जास्तीत जास्त 64 characters. यात lowercase letters, digits आणि hyphens एवढेच असू शकतात. तसेच यात claude किंवा anthropic हे words असू शकत नाहीत. personal किंवा project skill मध्ये, या नावाचा command आधीपासून वापरात नसल्यास, / menu मध्ये दाखवला जाणारा command हे नाव ठरवते. directory चे नाव वापरूनही कौशल्य invoke करता येते. त्यामुळे हे कौशल्य /nginx-config-changes नावालाही प्रतिसाद देते.
  • description: कौशल्य काय करते आणि ते कधी वापरायचे याचे वर्णन, जास्तीत जास्त 1,024 characters. ही line प्रत्यक्ष काम करते आणि पुढील section फक्त याच विषयावर आहे.
  • Body: instructions. कौशल्य प्रत्यक्ष सक्रिय झाल्यावरच त्या load केल्या जातात.
  • reference/: agent गरजेनुसार वाचतो अशा अतिरिक्त files. त्यांना SKILL.md मधून link करा आणि links एकाच स्तरावर ठेवा. कारण दुसऱ्या referenced file मधून reference केलेली file अनेकदा अंशतःच वाचली जाते.
  • scripts/: agent वाचण्याऐवजी execute करतो अशा files. Context साठी फक्त त्यांचे output मोजले जाते. त्यामुळे 300 lines असलेली script स्वस्त ठरते.

ज्या behaviour मध्ये सुधारणा करायची आहे ते पुरेसे हट्टी असेल आणि त्यासाठी स्वतंत्र रचना आवश्यक असेल, तेव्हा कौशल्य पूर्ण layout मध्ये वाढते. unlazy skill मध्ये हे स्थान Depth Tree, gates files चा संच आणि PLAN.md contract साठी वापरले जाते, ज्यामुळे कामाच्या संपूर्ण branches वर प्रक्रिया न करताही agent काम पूर्ण झाल्याचे जाहीर करू शकत नाही.

ही directory तुम्ही कुठे ठेवता यावर कौशल्य कोणाला उपलब्ध होईल हे ठरते.

  • .claude/skills/<name>/SKILL.md repository मध्ये: फक्त या project साठी. जो कोणी repo clone करेल त्याच्याकडेही ते पोहोचते.
  • ~/.claude/skills/<name>/SKILL.md: तुमच्या machine वरील प्रत्येक project साठी. इतर कोणाच्याही machine वर ते उपलब्ध होत नाही.
  • <plugin>/skills/<name>/SKILL.md: plugin मध्ये समाविष्ट केलेले. तो plugin enabled असेल तिथे ते उपलब्ध असते.

mkdir -p .claude/skills/nginx-config-changes वापरून कौशल्य तयार करा आणि file लिहा. Claude Code या directories वर लक्ष ठेवते. त्यामुळे विद्यमान कौशल्य edit केल्यास बदल running session मध्ये लागू होतात. नवीन कौशल्य दिसत नसेल, तर /reload-skills चालवा.

फाइलमधील description field ही सर्वाधिक परिणामकारक ओळ आहे

सुरू होताना agent उपलब्ध असलेल्या प्रत्येक skill चे name आणि description आपल्या context मध्ये लोड करतो. तो skill चे bodies लोड करत नाही. तुमची request आल्यावर हा skill संबंधित आहे की नाही हे ठरवण्यासाठी त्या एकाच ओळीचा संपूर्ण आधार घेतला जातो. त्यामुळे अस्पष्ट description मागे असलेला उत्तम body कधीही वाचला जात नाही.

description तृतीय पुरुषी लिहा. Tests and reloads nginx safely हे योग्य आहे. I can help you with nginx हे योग्य नाही, कारण हा मजकूर system prompt मध्ये inject केला जातो. अशा ठिकाणी प्रथमपुरुषी वाक्य model स्वतःबद्दल बोलत असल्यासारखे वाचले जाते.

description मध्ये दोन गोष्टी ठेवा: skill काय करतो आणि तो कोणत्या परिस्थितीत लागू होतो. महत्त्वाचा use case प्रथम लिहा, कारण Claude Code listing entry 1,536 characters वर truncate करतो. अतिरिक्त trigger phrases आणि example requests साठी पर्यायी when_to_use field उपलब्ध आहे. तो याच मर्यादेत description नंतर जोडला जातो.

त्यानंतर तुम्ही प्रत्यक्षात type करणार असलेले शब्द वापरा. description: Helps with nginx कशाशीही जुळत नाही, कारण कोणीही helps with असे type करत नाही. वरील आवृत्तीत /etc/nginx, server block, reverse proxy आणि TLS (transport layer security) certificate path यांचा उल्लेख आहे. एखाद्या request ने हा skill trigger करण्यासाठी आवश्यक असलेल्या शब्दसंग्रहाशी हे साधारणपणे जुळते.

description साठी ही चाचणी करा. body कधीही न पाहिलेल्या व्यक्तीला ती एक ओळ द्या आणि त्यासोबत तुम्ही type करणार असलेली request द्या. त्याला skill लागू होतो का ते विचारा. तो ठरवू शकत नसेल, तर model देखील ठरवू शकणार नाही.

मजकूर लहान ठेवा, कारण तो context मध्ये राहतो

skill invoke केल्यावर त्यातील render केलेला मजकूर एका message म्हणून conversation मध्ये येतो आणि session संपेपर्यंत तिथेच राहतो. Claude Code पुढील turns मध्ये ती file पुन्हा read करत नाही. तुम्ही लिहिलेली प्रत्येक line केवळ एका answer साठी नव्हे, तर संपूर्ण session साठी लागणारी किंमत असते.

Anthropic SKILL.md 500 lines पेक्षा कमी ठेवण्याची आणि सविस्तर माहिती स्वतंत्र files मध्ये हलवण्याची शिफारस करते. Compaction यामागचे कारण स्पष्ट करते. Context मोकळा करण्यासाठी conversation चे summary तयार केल्यावर Claude Code प्रत्येक skill चे सर्वात अलीकडील invocation पुन्हा जोडतो, प्रत्येकातील फक्त पहिले 5,000 tokens ठेवतो आणि एकत्रित 25,000 tokens चा budget सर्वात अलीकडे invoke केलेल्या skill पासून भरतो. मोठ्या skill चा मजकूर मध्येच truncate होतो. अनेक मोठ्या skills मुळे त्या एकमेकींना पूर्णपणे बाहेर ढकलू शकतात.

म्हणून model ला आधीपासून माहीत नसलेलीच माहिती लिहा. nginx काय आहे आणि reverse proxy काय करतो हे त्याला माहीत असते. reload हे restart पेक्षा जास्त असावे असा तुमचा स्थानिक नियम त्याला माहीत नसतो; ही file असण्याचे एकमेव कारण तो नियम आहे.

skill ने agent ला bundled script चालवण्यास सांगितले असल्यास, path मध्ये ${CLAUDE_SKILL_DIR} वापरा, म्हणजे skill जिथे install केले असेल तिथे तो योग्य प्रकारे resolve होईल. तसेच त्याच command ला आधीच approve करा, म्हणजे permission prompt मुळे run थांबणार नाही.

---
name: nginx-config-changes
description: Tests and reloads nginx safely after a config edit. Use when editing files under /etc/nginx, adding a server block or a reverse proxy, or changing a TLS certificate path.
allowed-tools: Bash(${CLAUDE_SKILL_DIR}/scripts/check-and-reload.sh *)
---

grant skill invoke केलेल्या turn पुरते असते आणि तुम्ही पुढील message पाठवल्यावर ते clear होते. त्यामुळे ती नकळत permanent permission बनत नाही.

कौशल्य कार्यरत होते हे कसे सिद्ध करावे

कौशल्य लोड होताना दिसल्याने agent ला ते सापडले हे कळते. मात्र उत्तर बदलले आहे का हे त्यावरून कळत नाही. दोन्ही गोष्टी तपासा. ही तपासणी नवीन session मध्ये करा, कारण कौशल्य लिहिलेला session लिहिताना तुम्ही दिलेली सर्व माहिती आधीच धरून ठेवतो. त्या उरलेल्या context मुळे फाइलमधील त्रुटी लपतात.

  1. प्रोजेक्टमध्ये claude वापरून नवीन session सुरू करा.
  2. कौशल्याचे नाव न घेता, नेहमीच्या कामाच्या दिवशी विनंती जशी कराल तशीच, स्वतःच्या शब्दांत विनंती लिहा.
  3. कौशल्य invoke झाले आहे का ते पाहा. कौशल्य invoke झाले नाही, तर description दुरुस्त करा. अद्याप body ही समस्या नाही.
  4. नियंत्रणासाठी /nginx-config-changes वापरून ते हाताने invoke करा. हाताने invoke केल्यावर योग्य वर्तन आणि विनंतीवरून invoke केल्यावर चुकीचे वर्तन दिसल्यास, ही instruction ची नव्हे तर trigger ची समस्या आहे.
  5. कौशल्य बंद ठेवून तीच विनंती पुन्हा चालवा आणि दोन्ही उत्तरे तुलना करा. /skills menu मध्ये कौशल्य highlight करा आणि त्याची स्थिती off वर आणण्यासाठी Space दाबा. नंतर जतन करण्यासाठी Esc दाबा. यामुळे .claude/settings.local.json मध्ये skillOverrides entry लिहिली जाते. काम पूर्ण झाल्यावर Space पुन्हा दाबल्यास स्थिती on वर परत येते.
  6. कौशल्य invoke होऊ नये अशा काही विनंत्या लिहा आणि त्या वेळी ते शांत राहते का ते तपासा.

ही प्रक्रिया स्वयंचलित करण्यासाठी अधिकृत marketplace मधून skill-creator plugin install करा.

/plugin marketplace add anthropics/claude-plugins-official
/plugin install skill-creator@claude-plugins-official

Install output मध्ये Run /reload-plugins to apply. दिसल्यास Claude Code तुमच्यासाठी तो reload चालवतो. Reload मुळे पुढील message मध्ये conversation पुन्हा वाचली जाईल असा इशारा मिळाल्यास /reload-plugins --force चालवा. त्यानंतर Claude ला तुमच्या कौशल्याचे नाव सांगून त्याचे मूल्यमापन करण्यास सांगा. Plugin test cases कौशल्याच्या directory मधील evals/evals.json मध्ये साठवतो आणि प्रत्येक case स्वतंत्र subagent मध्ये चालवतो. त्यामुळे प्रत्येक run स्वच्छ context पासून सुरू होतो. त्यानंतर तो with-skill आणि without-skill यांची तुलना लिहितो. हाच प्रामाणिक आकडा आहे: कौशल्यासाठी लागणारे tokens आणि वेळ लक्षात घेऊन मोजलेली pass rate मधील सुधारणा.

स्वतंत्र eval run वर अवलंबून न राहता कौशल्यातच त्याचा पुरावा ठेवता येतो. Old Coder कौशल्य agent कडून पुन्हा चालवता येईल असा evidence report मागवते, हे त्याचे उदाहरण आहे.

अपयशाची स्थिती: skill कधीच सक्रिय होत नाही

तुम्ही विनंती टाइप करता, agent पूर्वीची चुकीची कृती करतो आणि कोणतीही skill ओळ दिसत नाही. खालील कारणे क्रमाने तपासा.

  • Description मध्ये skill काय करते हे सांगितले आहे, पण ती कधी वापरायची हे सांगितलेले नाही. त्यामुळे तुमच्या विनंतीतील कोणताही मजकूर त्याच्याशी जुळत नाही.
  • Description मध्ये तुम्ही वापरत असलेले शब्द नाहीत. तुम्ही "nginx" म्हणत असाल, तर description मध्ये nginx असणे आवश्यक आहे.
  • disable-model-invocation: true frontmatter मध्ये सेट केलेले आहे. त्यामुळे description model च्या context मधून पूर्णपणे वगळले जाते आणि skill फक्त तुम्ही /name द्वारे invoke करू शकता.
  • Frontmatter मधील paths glob activation फक्त जुळणाऱ्या files पर्यंत मर्यादित करतो आणि तुम्ही ज्या file वर काम करत आहात ती त्याच्याशी जुळत नाही.
  • skill तुमच्या starting directory खालील nested .claude/skills/ directory मध्ये आहे. Agent त्या subdirectory मधील file वाचल्यानंतर किंवा संपादित केल्यानंतरच अशा skills load होतात. अथवा तुम्ही /add-dir द्वारे ती subdirectory add करू शकता. तोपर्यंत skill उपलब्धच नसते.

अपयशाची स्थिती: skill सतत सक्रिय होते

याच्या उलट समस्या अशी असते की description इतके व्यापक असते की skill असंबंधित कामांवरही सक्रिय होते. "सर्व्हरवर काम करताना वापरा" हे server repository मधील जवळपास कोणत्याही विनंतीशी जुळते. त्यानंतर body अशा task वर load होते ज्यात ते उपयुक्त ठरू शकत नाही, आणि उर्वरित session साठी ते context मध्ये राहते.

प्रत्यक्षात महत्त्वाच्या असलेल्या condition पर्यंत description मर्यादित करा आणि त्यात लागू असलेल्या files किंवा commands नमूद करा. skill फक्त विशिष्ट files साठी लागू असल्यास paths glob जोडा. deploy किंवा commit यांसारख्या side effects असलेल्या कोणत्याही कृतीसाठी disable-model-invocation: true सेट करा आणि /name वापरून ती स्वतः invoke करा. त्यामुळे deploy करण्यासाठी ही योग्य वेळ आहे असे agent स्वतःहून ठरवणार नाही.

अपयशाचा प्रकार: skill तुमच्या rules file मध्ये असायला हवे

CLAUDE.md किंवा AGENTS.md सारखे rules file प्रत्येक session च्या सुरुवातीला लोड होतात आणि प्रत्येक task वर लागू होतात. Skill body फक्त संबंधित skill सक्रिय झाल्यावर लोड होते. येथे निर्णय घेण्यासाठी वारंवारिता हा मुख्य निकष आहे. Repository मधील प्रत्येक task साठी लागू होणारी बाब, जसे की तुम्ही वापरत असलेला package manager, rules file मध्ये असायला हवी. कमी प्रकारच्या task साठी लागू होणारी प्रक्रिया, जसे की वरील nginx rule, skill मध्ये असायला हवी. ज्या दिवशी कोणीही nginx संपादित करत नाही, त्या दिवशी तिचा कोणताही खर्च होत नाही.

तीच सूचना दोन्ही ठिकाणी ठेवणे ही खरी चूक आहे. दोन प्रती कालांतराने वेगळ्या होतात. Agent चुकीची कृती करतो तेव्हा त्याने कोणती प्रत वापरली हे ठरवता येत नाही. प्रत्येक सूचनेसाठी एकच योग्य स्थान निवडा. एखादा rule नेमक्या एका ठिकाणी आधीपासूनच असतो आणि तरीही तो दुर्लक्षित केला जातो, तर ती वेगळी समस्या आहे. तो rule skill मध्ये हलवण्यापूर्वी दुर्लक्षित सूचनेमागील कार्यपद्धती तपासणे उपयुक्त ठरते. skills, MCP servers आणि rules files यांच्यातील सीमा अधिक गुंतागुंतीच्या परिस्थिती स्पष्ट करते. यात योग्य उत्तर MCP (model context protocol) server असू शकते. असा server agent ला नवीन सूचना देण्याऐवजी नवीन tool उपलब्ध करून देतो.

योग्य ठरल्यानंतर ते शेअर करा

प्रत्यक्ष कामाच्या एका आठवड्यानंतरही उपयोगी ठरणारे skill commit करणे योग्य असते. .claude/skills/ मधील project skills चे code प्रमाणे review केले जाते आणि ते repository सोबत येतात. त्यामुळे repository clone करणाऱ्या teammate ला कोणतीही setup प्रक्रिया न करता तुमचे correction मिळते. copy and paste न करता एखादे skill एका repository मधून दुसऱ्या repository मध्ये हलवणे ही स्वतंत्र समस्या आहे. तिचे वर्णन repositories मध्ये agent skills कसे शेअर करावे येथे केले आहे.

Portability संदर्भात एक महत्त्वाची नोंद आहे. Claude Code अनेक frontmatter fields स्वीकारते, परंतु Agent Skills standard मध्ये फक्त सहा fields अनुमत आहेत: name, description, license, compatibility, metadata आणि allowed-tools. frontmatter मध्ये यांव्यतिरिक्त काहीही ठेवून skill claude.ai वर upload केल्यास किंवा Skills API साठी package केल्यास ते field दुर्लक्षित होत नाही. प्रक्रिया थेट अपयशी ठरते:

Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name

या सहा fields पुरतेच मर्यादित राहिल्यास तीच file Claude Code मध्ये आणि standard वाचणाऱ्या इतर सर्व साधनांमध्ये load होते. File कुठे load होते यावर ती काय करू शकते हे ठरते. कारण Cowork Anthropic sandbox मध्ये चालते, तर Claude Code तुमच्या स्वतःच्या machine किंवा VPS वर चालते. त्यामुळे वरील nginx skill teammate च्या checkout मध्ये नेणे उपयोगी आहे; परंतु server पर्यंत पोहोचू न शकणाऱ्या sandbox मध्ये ते निरुपयोगी आहे. वेगळ्या model मध्येही टिकतील अशा पद्धतीने instructions लिहिणे हे स्वतंत्र काम आहे. त्यासाठी कोणत्याही model सोबत काम करणारी skills लिहिणे हे मार्गदर्शक आहे.

FAQ

SKILL.md फाइल किती मोठी असावी?

ती 500 ओळींपेक्षा कमी ठेवा. बहुतेक उपयुक्त skills यापेक्षा बऱ्याच लहान असतात. skill invoke झाल्यावर तिचा मुख्य मजकूर conversation मध्ये येतो आणि उर्वरित session मध्ये तिथेच राहतो. त्यामुळे प्रत्येक ओळ हा एकदाच होणारा खर्च नसून वारंवार होणारा खर्च असतो. मोठा reference material skill directory मधील स्वतंत्र files मध्ये ठेवा आणि त्यांना SKILL.md मधून link करा. ही रचना one level deep ठेवा, जेणेकरून agent ला ती files आवश्यक असेल तेव्हाच वाचाव्या लागतील. Bundled scripts वाचण्याऐवजी execute केल्या जातात. त्यामुळे त्यांचा खर्च फक्त त्यांच्या output इतकाच असतो.

माझी skill कधीच trigger का होत नाही?

याचे नेहमीचे कारण description असते. Model निर्णय घेताना skill चा context मध्ये असलेला एकमेव भाग description असतो. त्यामुळे description मध्ये skill काय करते एवढेच नव्हे, तर ती कधी वापरायची हेही लिहा. तसेच तुमच्या requests मध्ये तुम्ही प्रत्यक्ष वापरता ते शब्द त्यात आहेत याची खात्री करा. Description योग्य दिसत असल्यास frontmatter मध्ये disable-model-invocation: true आहे का ते तपासा. ते skill model पासून पूर्णपणे लपवते. तसेच paths glob तपासा. तो तुम्ही हाताळत नसलेल्या files पर्यंत skill मर्यादित करू शकतो. तुमच्या starting directory खालील nested .claude/skills/ directory मधील skill हे आणखी एक कारण असू शकते. Agent त्या subdirectory मधील file वाचल्यानंतर किंवा edit केल्यानंतरच ती load होते. किंवा तुम्ही /add-dir वापरून ती subdirectory जोडू शकता.

ही skill असावी की माझ्या rules file मधील एक ओळ?

ती तुमच्या किती tasks ला लागू होते याचा विचार करा. Rules file प्रत्येक session मध्ये load होते. त्यामुळे package manager किंवा branch naming convention यांसारखी प्रत्येक task साठी खरी असलेली माहिती त्यात ठेवावी. Skill फक्त trigger झाल्यावर load होते. त्यामुळे कमी प्रमाणातील tasks साठी आवश्यक असलेली procedure ठेवण्यासाठी ती योग्य जागा आहे. समान instruction दोन्ही ठिकाणी कधीही लिहू नका. दोन्ही copies मध्ये कालांतराने फरक पडतो आणि agent ने नेमकी कोणती copy पाळली हे ठरवता येत नाही.

Skill ने प्रत्यक्ष मदत केली हे मला कसे कळेल?

तिची baseline शी तुलना करा. काही वास्तविक requests गोळा करा. Skill उपलब्ध असलेल्या fresh session मध्ये प्रत्येक request चालवा. त्यानंतर /skills menu मधून skill बंद करून त्याच requests पुन्हा चालवा. दोन्ही answers शेजारी ठेवून वाचा. Fresh session महत्त्वाचे आहे. कारण skill लिहिलेली conversation तुमचे explanations अजूनही ठेवते. त्यामुळे अपूर्ण file देखील पूर्ण असल्यासारखी दिसू शकते. skill-creator plugin ही तुलना तुमच्यासाठी करते आणि token cost च्या बाजूला pass rate दाखवते.

वेगळ्या agent सोबत तीच SKILL.md वापरता येते का?

होय. Agent Skills standard ने निश्चित केलेल्या fields च्या मर्यादेत राहिल्यास हे शक्य आहे: name, description, license, compatibility, metadata आणि allowed-tools. Claude Code आणखी अनेक fields स्वीकारते. तसेच इतर tools execute करत नाहीत अशा shell command injection सारख्या body features चेही ते समर्थन करते. Standard च्या बाहेरील field असलेली skill upload केल्यास allowed properties ची यादी देणारी explicit error मिळते. त्यामुळे skill फक्त Claude Code मध्ये ठेवायची आहे की वेगवेगळ्या tools मध्ये वापरायची आहे, हे सुरुवातीलाच ठरवा.

हा लेख उपयुक्त होता का?