फाइल फॉरमॅट
SKILL.md हा UTF-8 मजकूर आहे. तो तीन हायफनच्या ओळीने सुरू होतो, मग YAML फ्रंटमॅटर, मग तीन हायफनची बंद करणारी ओळ. त्यानंतरचे सर्व म्हणजे बॉडी: कौशल्य लोड केल्यावर कर्मचाऱ्याला मिळणाऱ्या Markdown सूचना. Nebo लहान-मोठ्या अक्षरांचा विचार न करता फाइल नावाने शोधते.
---
name: expense-review
description: Check submitted expenses against the company policy and flag anything that needs a receipt or an approval. Use when someone asks to review expenses or a reimbursement request.
version: "1.2.0"
author: Example Co
license: MIT
tags: [finance, expenses]
triggers: [reimbursement, expense report]
platform: [macos, linux, windows]
capabilities: [network]
metadata:
allowed_domains: [api.example.com]
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true
requires:
- name: receipt-capture
version: ">=1.0.0"
plugins:
- name: example-ledger
version: ">=2.0.0"
optional: true
---
# Expense review
Follow the policy in references/policy.md ... फ्रंटमॅटर फील्ड
फक्त name आणि description आवश्यक आहेत. चुकीच्या प्रकाराचे फील्ड संपूर्ण फाइल अयशस्वी करते, त्यामुळे कौशल्य लोड होत नाही. येथे सूचीबद्ध नसलेल्या की दुर्लक्षित केल्या जातात.
| फील्ड | प्रकार | डीफॉल्ट | अर्थ |
|---|---|---|---|
name | string | आवश्यक | ओळखकर्ता. [a-z0-9-], सुरुवातीला, शेवटी किंवा दुहेरी हायफन नाही, जास्तीत जास्त 64 बाइट्स. फोल्डरच्या नावाशी जुळवा. |
description | string | आवश्यक | कौशल्य काय करते आणि ते कधी वापरायचे. जास्तीत जास्त 1,024 बाइट्स. कर्मचाऱ्याच्या कौशल्य यादीत दाखवले जाते आणि find_skills द्वारे गुण दिले जातात. |
version | string | "1.0.0" | सिमँटिक व्हर्जन. इतर कौशल्यांच्या requires श्रेणींद्वारे तपासले जाते. ते अवतरण चिन्हांत लिहा. |
triggers | स्ट्रिंगची यादी | [] | कौशल्य कधी लागू होते याचे वर्णन करणारे शब्द आणि वाक्यांश. कौशल्य यादीत जास्तीत जास्त तीन दिसतात; find_skills मध्ये सर्व गणले जातात. ते कधीही स्वतःहून कौशल्य लोड करत नाहीत. |
platform | स्ट्रिंगची यादी | सर्व | macos, linux, windows. यांपैकी एखादे जुळते तिथेच कौशल्य लोड होते. |
capabilities | स्ट्रिंगची यादी | [] | network आणि storage स्क्रिप्ट सँडबॉक्स विस्तारतात. Script sandbox पहा. |
metadata | map | {} | secrets आणि allowed_domains ठेवते. खाली पहा. |
requires | {name, version} ची यादी | [] | हे कौशल्य ज्यांच्यावर आधारित आहे ती इतर कौशल्ये. name हे कौशल्याचे छोटे नाव; version ही semver श्रेणी, डीफॉल्ट "*". |
plugins | {name, version, optional} ची यादी | [] | हे कौशल्य वापरत असलेले प्लगइन. version डीफॉल्ट "*", optional डीफॉल्ट false. |
dependencies | स्ट्रिंगची यादी | [] | उपस्थित असणे आवश्यक असलेल्या कौशल्यांची छोटी नावे. |
priority | integer | 0 | व्यवस्थापन यादीतील कौशल्यांचा क्रम ठरवते. कर्मचारी कोणते कौशल्य निवडतो यावर याचा परिणाम होत नाही. |
author | string | "" | दाखवण्यासाठी साठवले जाते. |
license | string | "" | दाखवण्यासाठी साठवले जाते. |
compatibility | string | "" | मुक्त-मजकूर टीप, जास्तीत जास्त 500 बाइट्स. |
tags | स्ट्रिंगची यादी | [] | दाखवण्यासाठी साठवले जाते. |
allowed-tools | string | "" | स्पेसने वेगळी केलेली स्ट्रिंग. साठवली जाते; लागू केली जात नाही. |
requires किंवा dependencies मध्ये नाव असलेले कौशल्य नसल्यास किंवा श्रेणीबाहेर असल्यास, किंवा आवश्यक प्लगइन इंस्टॉल नसल्यास, कौशल्य तरीही लोड होते आणि degraded म्हणून चिन्हांकित होते. काय कमी आहे ते मालकाला दिसते.
सिक्रेट
कौशल्याच्या स्क्रिप्टना लागणारी क्रेडेन्शियल्स metadata.secrets खाली जाहीर करा. मालक मूल्ये देतो, आणि Nebo ती त्या कौशल्यासाठी एन्क्रिप्ट करून साठवते.
metadata:
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true | की | अर्थ |
|---|---|
key | स्क्रिप्टला मिळणाऱ्या एन्व्हायर्नमेंट व्हेरिएबलचे नाव. आवश्यक. |
label | मालकाला दाखवले जाणारे नाव. |
hint | मूल्य कुठून मिळवायचे. |
required | true असताना, मूल्य सेट होईपर्यंत execute कौशल्याच्या स्क्रिप्ट चालवण्यास नकार देते. डीफॉल्ट false. |
कर्मचारी configure_skill ने मूल्य सेट करतो. तुम्ही मुख्य मजकुरात सिक्रेटचा संदर्भ ${secret.KEY} असा देऊ शकता, पण स्क्रिप्ट्सनी त्याऐवजी environment variable वाचावे.
टेम्पलेट व्हेरिएबल
कर्मचारी कौशल्य लोड करतो तेव्हा Nebo बॉडीमधील हे व्हेरिएबल बदलते. इतर फाइल्समध्ये ते बदलले जात नाहीत; स्क्रिप्ट त्याऐवजी एन्व्हायर्नमेंट व्हेरिएबल वाचतात.
| व्हेरिएबल | मूल्य |
|---|---|
${NEBO_SKILL_DIR} | कौशल्याच्या फोल्डरचा पूर्ण पाथ. |
${NEBO_DATA_DIR} | या कौशल्यासाठी लिहिता येणारे फोल्डर: <data>/appdata/skills/<name>. पहिल्या वापरावेळी तयार होते. |
${NEBO_USER_NAME} | मालकाचे नाव. |
${NEBO_OS} | ऑपरेटिंग सिस्टम. |
${NEBO_ARCH} | प्रोसेसर आर्किटेक्चर. |
${plugin.SLUG_BIN} | जाहीर केलेल्या प्लगइनच्या बायनरीचा पाथ. slug मोठ्या अक्षरांत, हायफनऐवजी अंडरस्कोरसह लिहिला जातो: example-ledger चे ${plugin.EXAMPLE_LEDGER_BIN} होते. |
${secret.KEY} | जाहीर केलेल्या सिक्रेटचे मूल्य. |
$ARGUMENTS | use_skill ला पाठवलेले args. बॉडीमध्ये $ARGUMENTS नसल्यास, आर्ग्युमेंट तिच्या शेवटी जोडले जातात. |
कौशल्य टूल
कर्मचारी या टूलद्वारे कौशल्यांसोबत काम करतात. use_skill नेहमी उपलब्ध असते; बाकीची कर्मचाऱ्याला गरज असेल तेव्हा लोड होतात.
| टूल | पॅरामीटर | ते काय करते |
|---|---|---|
use_skill | name, args | कौशल्य लोड करते. विस्तारित बॉडी, फोल्डर पाथ आणि पहिली 20 फाइल नावे परत देते. बंद केलेले कौशल्य पुन्हा सक्षम करते. |
find_skills | query | नाव, ट्रिगर आणि वर्णन जुळण्यानुसार क्रम लावलेली जास्तीत जास्त 10 कौशल्ये परत देते. |
read_skill_file | name, path | कौशल्याच्या फोल्डरमधील फाइल वाचते. path शिवाय, फाइल्स आणि त्यांचे आकार यांची यादी देते. |
save_skill | name, content | युजर स्किल्स फोल्डरमध्ये पूर्ण SKILL.md लिहिते. मार्केटप्लेस कौशल्ये ओव्हरराइट करता येत नाहीत. |
delete_skill | name | युजर कौशल्य हटवते. |
install_skill | code | मार्केटप्लेस कौशल्य त्याच्या SKIL- इंस्टॉल कोडवरून इंस्टॉल करते. |
configure_skill | name, key, value | सिक्रेट सेट करते. key शिवाय, कौशल्याला काय हवे आहे ते दाखवते. |
rate_skill | name, rating, review | मार्केटप्लेस कौशल्याला 1 ते 5 रेटिंग देते. |
read_skill_reviews | name | मार्केटप्लेस कौशल्याची पुनरावलोकने वाचते. |
execute | skill, script, args, timeout | कौशल्याच्या फोल्डरमधील स्क्रिप्ट चालवते. Script sandbox पहा. |
स्क्रिप्ट सँडबॉक्स
execute टूल कौशल्याच्या फोल्डरमधील एक स्क्रिप्ट चालवते. ते फाइलवरून रनटाइम निवडते.
| स्क्रिप्ट | रनटाइम |
|---|---|
.py | Python, उपलब्ध असल्यास Nebo सोबत आलेल्या uv मार्फत, अन्यथा python3. |
.ts, .js | उपलब्ध असल्यास Nebo सोबत आलेले Bun, अन्यथा node. |
bin/<file> किंवा binary | थेट चालवा. |
.sh | समर्थित नाही. |
प्रत्येक रन रिकाम्या एन्व्हायर्नमेंटने आणि या व्हेरिएबलसह सुरू होतो:
| व्हेरिएबल | मूल्य |
|---|---|
SKILL_ARGS | JSON स्वरूपातील args ऑब्जेक्ट. |
प्रत्येक सिक्रेट key | डिक्रिप्ट केलेले सिक्रेट मूल्य. |
<PLUGIN>_BIN | जाहीर केलेल्या प्रत्येक प्लगइनच्या बायनरीचा पाथ. प्लगइन फोल्डर PATH मध्येही जोडले जातात. |
import json, os
args = json.loads(os.environ.get("SKILL_ARGS", "{}"))
api_key = os.environ["EXAMPLE_API_KEY"]
print(json.dumps({"checked": len(args.get("items", []))})) स्क्रिप्ट कौशल्य फोल्डरच्या तात्पुरत्या प्रतीमध्ये चालते, 30 सेकंदांच्या डीफॉल्ट टाइमआउटसह. macOS आणि Linux वर ती ऑपरेटिंग-सिस्टम सँडबॉक्समध्ये चालते:
- ती क्रेडेन्शियल स्टोअर, ब्राउझर आणि कीचेन डेटा, किंवा Nebo च्या स्वतःच्या सेटिंग्ज आणि डेटाबेस वाचू शकत नाही.
- ती फक्त तिच्या वर्किंग फोल्डरमध्ये आणि
/tmp/neboमध्ये लिहू शकते.storageक्षमता Nebo चे डेटा फोल्डर जोडते. - तिला नेटवर्क ॲक्सेस नसतो.
networkक्षमता पॅकेज रजिस्ट्री आणिmetadata.allowed_domainsमध्ये सूचीबद्ध डोमेनना परवानगी देते.
फाइल्स आणि मर्यादा
| घटक | नियम |
|---|---|
| संसाधने | SKILL.md, manifest.json, signatures.json आणि डॉटफाइल्स वगळता प्रत्येक फाइल. |
| एक्झिक्यूटेबल | scripts/ किंवा bin/ खालील फाइल्स, आणि binary नावाची रूट फाइल. |
| पाथ | कौशल्य फोल्डरच्या सापेक्ष. .. असलेले किंवा फोल्डरबाहेर जाणारे पाथ नाकारले जातात. |
| बंद केलेले कौशल्य | SKILL.md ऐवजी SKILL.md.disabled असलेले फोल्डर. |
| कौशल्य यादी | प्रत्येक नोंद 250 अक्षरांवर कापली जाते. संपूर्ण यादी 8,000 अक्षरांपेक्षा जास्त झाल्यास आधी सामायिक कौशल्ये लहान केली जातात; कर्मचाऱ्याच्या स्वतःच्या कौशल्यांच्या नोंदी पूर्ण राहतात. |
तुम्ही मार्केटप्लेसवर प्रकाशित करत असलेल्या फाइल्सच्या मर्यादा प्रकाशन पेजवर आहेत.