ফাইলের ফরম্যাট
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 অক্ষরের বেশি হলে প্রথমে শেয়ার্ড দক্ষতাগুলো ছোট করা হয়; কর্মীর নিজের দক্ষতাগুলোর এন্ট্রি পুরোপুরি থাকে। |
মার্কেটপ্লেসে প্রকাশ করা ফাইলের সীমাগুলো প্রকাশ করা পৃষ্ঠায় দেওয়া আছে।