ഫയൽ ഫോർമാറ്റ്
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 എന്നിവ സ്ക്രിപ്റ്റ് സാൻഡ്ബോക്സ് വിപുലമാക്കുന്നു. Script sandbox കാണുക. |
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 | ഒരു സ്കില്ലിന്റെ ഫോൾഡറിൽ നിന്ന് ഒരു സ്ക്രിപ്റ്റ് പ്രവർത്തിപ്പിക്കുന്നു. Script sandbox കാണുക. |
സ്ക്രിപ്റ്റ് സാൻഡ്ബോക്സ്
execute ടൂൾ ഒരു സ്കില്ലിന്റെ ഫോൾഡറിൽ നിന്ന് ഒരു സ്ക്രിപ്റ്റ് പ്രവർത്തിപ്പിക്കുന്നു. ഫയലിൽ നിന്നാണ് ഇത് റൺടൈം തിരഞ്ഞെടുക്കുന്നത്.
| സ്ക്രിപ്റ്റ് | റൺടൈം |
|---|---|
.py | Python, ഉണ്ടെങ്കിൽ Nebo-യുടെ ഒപ്പമുള്ള uv വഴി, ഇല്ലെങ്കിൽ python3. |
.ts, .js | ഉണ്ടെങ്കിൽ Nebo-യുടെ ഒപ്പമുള്ള Bun, ഇല്ലെങ്കിൽ node. |
bin/<file> അല്ലെങ്കിൽ binary | നേരിട്ട് പ്രവർത്തിപ്പിക്കുന്നു. |
.sh | പിന്തുണയ്ക്കുന്നില്ല. |
ഓരോ റണ്ണും ഒരു ശൂന്യമായ എൻവയോൺമെന്റിലും ഈ വേരിയബിളുകളോടെയും ആരംഭിക്കുന്നു:
| വേരിയബിൾ | മൂല്യം |
|---|---|
SKILL_ARGS | args ഒബ്ജക്റ്റ് 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 അക്ഷരങ്ങൾ കവിയുമ്പോൾ, പങ്കിട്ട സ്കില്ലുകൾ ആദ്യം ചുരുക്കുന്നു; ഒരു ജീവനക്കാരന്റെ സ്വന്തം സ്കില്ലുകൾക്ക് പൂർണ്ണ എൻട്രികൾ നിലനിൽക്കും. |
നിങ്ങൾ മാർക്കറ്റ്പ്ലേസിലേക്ക് പ്രസിദ്ധീകരിക്കുന്ന ഫയലുകൾക്കുള്ള പരിധികൾ പ്രസിദ്ധീകരണം പേജിലുണ്ട്.