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