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 स्क्रिप्ट सैंडबॉक्स को बढ़ाते हैं। स्क्रिप्ट सैंडबॉक्स देखें।
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 में नामित कोई स्किल मौजूद न हो या रेंज से बाहर हो, या कोई ज़रूरी प्लगइन इंस्टॉल न हो, तब भी स्किल लोड होती है और अधूरी चिह्नित होती है। मालिक देखता है कि क्या कमी है।

सीक्रेट

किसी स्किल की स्क्रिप्ट को जिन क्रेडेंशियल की ज़रूरत है, उन्हें 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} के रूप में दे सकते हैं, हालाँकि स्क्रिप्ट को इसके बजाय एनवायरनमेंट वेरिएबल पढ़ना चाहिए।

टेम्पलेट वेरिएबल

जब कोई कर्मचारी स्किल लोड करता है, तो 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स्किल के फ़ोल्डर से एक स्क्रिप्ट चलाता है। स्क्रिप्ट सैंडबॉक्स देखें।

स्क्रिप्ट सैंडबॉक्स

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 अक्षरों से ज़्यादा हो जाए, तो पहले साझा स्किल छोटी की जाती हैं; कर्मचारी की अपनी स्किल की एंट्री पूरी रहती हैं।

मार्केटप्लेस पर प्रकाशित की जाने वाली फ़ाइलों की सीमाएँ प्रकाशन पेज पर हैं।