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, .jsNebo-র বান্ডেল করা 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 অক্ষরের বেশি হলে প্রথমে শেয়ার্ড দক্ষতাগুলো ছোট করা হয়; কর্মীর নিজের দক্ষতাগুলোর এন্ট্রি পুরোপুরি থাকে।

মার্কেটপ্লেসে প্রকাশ করা ফাইলের সীমাগুলো প্রকাশ করা পৃষ্ঠায় দেওয়া আছে।