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-ലോ പേര് നൽകിയ ഒരു സ്കിൽ ഇല്ലാതിരിക്കുകയോ ശ്രേണിക്ക് പുറത്താകുകയോ, നിർബന്ധമായ ഒരു പ്ലഗിൻ ഇൻസ്റ്റാൾ ചെയ്യാതിരിക്കുകയോ ചെയ്യുമ്പോൾ, സ്കിൽ ലോഡ് ആകുകയും പരിമിതമായത് എന്ന് അടയാളപ്പെടുത്തുകയും ചെയ്യുന്നു. എന്താണ് കുറവുള്ളതെന്ന് ഉടമ കാണുന്നു.

സീക്രട്ടുകൾ

ഒരു സ്കില്ലിന്റെ സ്ക്രിപ്റ്റുകൾക്ക് ആവശ്യമായ ക്രെഡൻഷ്യലുകൾ 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ഒരു സ്കില്ലിന്റെ ഫോൾഡറിൽ നിന്ന് ഒരു സ്ക്രിപ്റ്റ് പ്രവർത്തിപ്പിക്കുന്നു. Script sandbox കാണുക.

സ്ക്രിപ്റ്റ് സാൻഡ്ബോക്സ്

execute ടൂൾ ഒരു സ്കില്ലിന്റെ ഫോൾഡറിൽ നിന്ന് ഒരു സ്ക്രിപ്റ്റ് പ്രവർത്തിപ്പിക്കുന്നു. ഫയലിൽ നിന്നാണ് ഇത് റൺടൈം തിരഞ്ഞെടുക്കുന്നത്.

സ്ക്രിപ്റ്റ്റൺടൈം
.pyPython, ഉണ്ടെങ്കിൽ Nebo-യുടെ ഒപ്പമുള്ള uv വഴി, ഇല്ലെങ്കിൽ python3.
.ts, .jsഉണ്ടെങ്കിൽ Nebo-യുടെ ഒപ്പമുള്ള Bun, ഇല്ലെങ്കിൽ node.
bin/<file> അല്ലെങ്കിൽ binaryനേരിട്ട് പ്രവർത്തിപ്പിക്കുന്നു.
.shപിന്തുണയ്ക്കുന്നില്ല.

ഓരോ റണ്ണും ഒരു ശൂന്യമായ എൻവയോൺമെന്റിലും ഈ വേരിയബിളുകളോടെയും ആരംഭിക്കുന്നു:

വേരിയബിൾമൂല്യം
SKILL_ARGSargs ഒബ്ജക്റ്റ് JSON ആയി.
ഓരോ സീക്രട്ട് 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 അക്ഷരങ്ങൾ കവിയുമ്പോൾ, പങ്കിട്ട സ്കില്ലുകൾ ആദ്യം ചുരുക്കുന്നു; ഒരു ജീവനക്കാരന്റെ സ്വന്തം സ്കില്ലുകൾക്ക് പൂർണ്ണ എൻട്രികൾ നിലനിൽക്കും.

നിങ്ങൾ മാർക്കറ്റ്പ്ലേസിലേക്ക് പ്രസിദ്ധീകരിക്കുന്ന ഫയലുകൾക്കുള്ള പരിധികൾ പ്രസിദ്ധീകരണം പേജിലുണ്ട്.