NeboAI
NeboAI
सुरू करा

SKILL.md संदर्भ

हे पेज Nebo वाचत असलेल्या कौशल्याच्या प्रत्येक भागाची यादी देते: फ्रंटमॅटर फील्ड, ते विस्तारित करत असलेले व्हेरिएबल, कर्मचारी कौशल्यांसोबत काम करण्यासाठी वापरत असलेली टूल, आणि स्क्रिप्ट ज्या एन्व्हायर्नमेंटमध्ये चालतात ते.

फाइल फॉरमॅट

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 आवश्यक आहेत. चुकीच्या प्रकाराचे फील्ड संपूर्ण फाइल अयशस्वी करते, त्यामुळे कौशल्य लोड होत नाही. येथे सूचीबद्ध नसलेल्या की दुर्लक्षित केल्या जातात.

फील्डप्रकारडीफॉल्टअर्थ
namestringआवश्यकओळखकर्ता. [a-z0-9-], सुरुवातीला, शेवटी किंवा दुहेरी हायफन नाही, जास्तीत जास्त 64 बाइट्स. फोल्डरच्या नावाशी जुळवा.
descriptionstringआवश्यककौशल्य काय करते आणि ते कधी वापरायचे. जास्तीत जास्त 1,024 बाइट्स. कर्मचाऱ्याच्या कौशल्य यादीत दाखवले जाते आणि find_skills द्वारे गुण दिले जातात.
versionstring"1.0.0"सिमँटिक व्हर्जन. इतर कौशल्यांच्या requires श्रेणींद्वारे तपासले जाते. ते अवतरण चिन्हांत लिहा.
triggersस्ट्रिंगची यादी[]कौशल्य कधी लागू होते याचे वर्णन करणारे शब्द आणि वाक्यांश. कौशल्य यादीत जास्तीत जास्त तीन दिसतात; find_skills मध्ये सर्व गणले जातात. ते कधीही स्वतःहून कौशल्य लोड करत नाहीत.
platformस्ट्रिंगची यादीसर्वmacos, linux, windows. यांपैकी एखादे जुळते तिथेच कौशल्य लोड होते.
capabilitiesस्ट्रिंगची यादी[]network आणि storage स्क्रिप्ट सँडबॉक्स विस्तारतात. Script sandbox पहा.
metadatamap{}secrets आणि allowed_domains ठेवते. खाली पहा.
requires{name, version} ची यादी[]हे कौशल्य ज्यांच्यावर आधारित आहे ती इतर कौशल्ये. name हे कौशल्याचे छोटे नाव; version ही semver श्रेणी, डीफॉल्ट "*".
plugins{name, version, optional} ची यादी[]हे कौशल्य वापरत असलेले प्लगइन. version डीफॉल्ट "*", optional डीफॉल्ट false.
dependenciesस्ट्रिंगची यादी[]उपस्थित असणे आवश्यक असलेल्या कौशल्यांची छोटी नावे.
priorityinteger0व्यवस्थापन यादीतील कौशल्यांचा क्रम ठरवते. कर्मचारी कोणते कौशल्य निवडतो यावर याचा परिणाम होत नाही.
authorstring""दाखवण्यासाठी साठवले जाते.
licensestring""दाखवण्यासाठी साठवले जाते.
compatibilitystring""मुक्त-मजकूर टीप, जास्तीत जास्त 500 बाइट्स.
tagsस्ट्रिंगची यादी[]दाखवण्यासाठी साठवले जाते.
allowed-toolsstring""स्पेसने वेगळी केलेली स्ट्रिंग. साठवली जाते; लागू केली जात नाही.

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मूल्य कुठून मिळवायचे.
requiredtrue असताना, मूल्य सेट होईपर्यंत 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}जाहीर केलेल्या सिक्रेटचे मूल्य.
$ARGUMENTSuse_skill ला पाठवलेले args. बॉडीमध्ये $ARGUMENTS नसल्यास, आर्ग्युमेंट तिच्या शेवटी जोडले जातात.

कौशल्य टूल

कर्मचारी या टूलद्वारे कौशल्यांसोबत काम करतात. use_skill नेहमी उपलब्ध असते; बाकीची कर्मचाऱ्याला गरज असेल तेव्हा लोड होतात.

टूलपॅरामीटरते काय करते
use_skillname, argsकौशल्य लोड करते. विस्तारित बॉडी, फोल्डर पाथ आणि पहिली 20 फाइल नावे परत देते. बंद केलेले कौशल्य पुन्हा सक्षम करते.
find_skillsqueryनाव, ट्रिगर आणि वर्णन जुळण्यानुसार क्रम लावलेली जास्तीत जास्त 10 कौशल्ये परत देते.
read_skill_filename, pathकौशल्याच्या फोल्डरमधील फाइल वाचते. path शिवाय, फाइल्स आणि त्यांचे आकार यांची यादी देते.
save_skillname, contentयुजर स्किल्स फोल्डरमध्ये पूर्ण SKILL.md लिहिते. मार्केटप्लेस कौशल्ये ओव्हरराइट करता येत नाहीत.
delete_skillnameयुजर कौशल्य हटवते.
install_skillcodeमार्केटप्लेस कौशल्य त्याच्या SKIL- इंस्टॉल कोडवरून इंस्टॉल करते.
configure_skillname, key, valueसिक्रेट सेट करते. key शिवाय, कौशल्याला काय हवे आहे ते दाखवते.
rate_skillname, rating, reviewमार्केटप्लेस कौशल्याला 1 ते 5 रेटिंग देते.
read_skill_reviewsnameमार्केटप्लेस कौशल्याची पुनरावलोकने वाचते.
executeskill, script, args, timeoutकौशल्याच्या फोल्डरमधील स्क्रिप्ट चालवते. Script sandbox पहा.

स्क्रिप्ट सँडबॉक्स

execute टूल कौशल्याच्या फोल्डरमधील एक स्क्रिप्ट चालवते. ते फाइलवरून रनटाइम निवडते.

स्क्रिप्टरनटाइम
.pyPython, उपलब्ध असल्यास Nebo सोबत आलेल्या uv मार्फत, अन्यथा python3.
.ts, .jsउपलब्ध असल्यास Nebo सोबत आलेले Bun, अन्यथा node.
bin/<file> किंवा binaryथेट चालवा.
.shसमर्थित नाही.

प्रत्येक रन रिकाम्या एन्व्हायर्नमेंटने आणि या व्हेरिएबलसह सुरू होतो:

व्हेरिएबलमूल्य
SKILL_ARGSJSON स्वरूपातील 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 अक्षरांपेक्षा जास्त झाल्यास आधी सामायिक कौशल्ये लहान केली जातात; कर्मचाऱ्याच्या स्वतःच्या कौशल्यांच्या नोंदी पूर्ण राहतात.

तुम्ही मार्केटप्लेसवर प्रकाशित करत असलेल्या फाइल्सच्या मर्यादा प्रकाशन पेजवर आहेत.