Formatul fișierului
SKILL.md este text UTF-8. Începe cu o linie de trei cratime, urmată de frontmatter YAML, apoi de o linie de închidere cu trei cratime. Tot ce urmează este corpul: instrucțiunile Markdown pe care angajatul le primește când încarcă abilitatea. Nebo găsește fișierul după nume, indiferent de majuscule.
---
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 ... Câmpuri de frontmatter
Doar name și description sunt obligatorii. Un câmp cu tipul greșit invalidează întregul fișier, așa că abilitatea nu se încarcă. Cheile care nu sunt listate aici sunt ignorate.
| Câmp | Tip | Implicit | Semnificație |
|---|---|---|---|
name | string | obligatoriu | Identificator. [a-z0-9-], fără cratimă la început, la sfârșit sau dublă, cel mult 64 de octeți. Trebuie să corespundă cu numele folderului. |
description | string | obligatoriu | Ce face abilitatea și când se folosește. Cel mult 1.024 de octeți. Afișată în lista de abilități a angajatului și punctată de find_skills. |
version | string | "1.0.0" | Versiune semantică. Verificată de intervalele requires ale altor abilități. Pune-o între ghilimele. |
triggers | listă de șiruri | [] | Cuvinte și expresii care descriu când se aplică abilitatea. Până la trei apar în lista de abilități; toate contează în find_skills. Nu încarcă niciodată singure o abilitate. |
platform | listă de șiruri | toate | macos, linux, windows. Abilitatea se încarcă doar acolo unde una se potrivește. |
capabilities | listă de șiruri | [] | network și storage lărgesc sandboxul pentru scripturi. Vezi Sandboxul pentru scripturi. |
metadata | map | {} | Conține secrets și allowed_domains. Vezi mai jos. |
requires | listă de {name, version} | [] | Alte abilități pe care se bazează această abilitate. name este numele scurt al abilității; version este un interval semver, implicit "*". |
plugins | listă de {name, version, optional} | [] | Pluginurile pe care le folosește această abilitate. version are implicit valoarea "*", optional are false. |
dependencies | listă de șiruri | [] | Numele scurte ale abilităților care trebuie să fie prezente. |
priority | integer | 0 | Ordonează abilitățile în listele de administrare. Nu influențează ce abilitate alege un angajat. |
author | string | "" | Stocat pentru afișare. |
license | string | "" | Stocat pentru afișare. |
compatibility | string | "" | Notă liberă, de cel mult 500 de octeți. |
tags | listă de șiruri | [] | Stocat pentru afișare. |
allowed-tools | string | "" | Un șir separat prin spații. Stocat; nu este impus. |
Când o abilitate numită în requires sau dependencies lipsește ori este în afara intervalului, sau un plugin necesar nu este instalat, abilitatea se încarcă totuși și este marcată ca degradată. Proprietarul vede ce lipsește.
Secrete
Declară datele de acces de care au nevoie scripturile unei abilități sub metadata.secrets. Proprietarul furnizează valorile, iar Nebo le stochează criptate pentru acea abilitate.
metadata:
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true | Cheie | Semnificație |
|---|---|
key | Numele variabilei de mediu pe care o primește scriptul. Obligatoriu. |
label | Numele afișat proprietarului. |
hint | De unde se obține valoarea. |
required | Când este true, execute refuză să ruleze scripturile abilității până când valoarea este setată. Implicit false. |
Un angajat setează o valoare cu configure_skill. Poți face referire la un secret în corpul textului ca ${secret.KEY}, deși scripturile ar trebui să citească în schimb variabila de mediu.
Variabile de șablon
Nebo înlocuiește aceste variabile în corp când un angajat încarcă abilitatea. Ele nu sunt înlocuite în alte fișiere; scripturile citesc în schimb variabile de mediu.
| Variabilă | Valoare |
|---|---|
${NEBO_SKILL_DIR} | Calea absolută a folderului abilității. |
${NEBO_DATA_DIR} | Un folder cu drept de scriere pentru această abilitate: <data>/appdata/skills/<name>. Creat la prima utilizare. |
${NEBO_USER_NAME} | Numele proprietarului. |
${NEBO_OS} | Sistemul de operare. |
${NEBO_ARCH} | Arhitectura procesorului. |
${plugin.SLUG_BIN} | Calea binarului unui plugin declarat. Slugul este scris cu majuscule, cu cratimele înlocuite de liniuțe de subliniere: example-ledger devine ${plugin.EXAMPLE_LEDGER_BIN}. |
${secret.KEY} | Valoarea unui secret declarat. |
$ARGUMENTS | args transmise către use_skill. Când corpul nu conține $ARGUMENTS, argumentele sunt adăugate după el. |
Instrumente pentru abilități
Angajații lucrează cu abilitățile prin aceste instrumente. use_skill este disponibil întotdeauna; celelalte se încarcă atunci când un angajat are nevoie de ele.
| Instrument | Parametri | Ce face |
|---|---|---|
use_skill | name, args | Încarcă o abilitate. Returnează corpul extins, calea folderului și primele 20 de nume de fișiere. Reactivează o abilitate dezactivată. |
find_skills | query | Returnează până la 10 abilități ordonate după potrivirile cu numele, declanșatoarele și descrierea. |
read_skill_file | name, path | Citește un fișier din folderul abilității. Fără path, listează fișierele și dimensiunile lor. |
save_skill | name, content | Scrie un SKILL.md complet în folderul de abilități al utilizatorului. Abilitățile din magazin nu pot fi suprascrise. |
delete_skill | name | Șterge o abilitate a utilizatorului. |
install_skill | code | Instalează o abilitate din magazin pe baza codului de instalare SKIL-. |
configure_skill | name, key, value | Setează un secret. Fără key, arată de ce are nevoie abilitatea. |
rate_skill | name, rating, review | Evaluează o abilitate din magazin de la 1 la 5. |
read_skill_reviews | name | Citește recenziile unei abilități din magazin. |
execute | skill, script, args, timeout | Rulează un script din folderul unei abilități. Vezi Sandboxul pentru scripturi. |
Sandboxul pentru scripturi
Instrumentul execute rulează un script din folderul unei abilități. Alege mediul de rulare în funcție de fișier.
| Script | Mediu de rulare |
|---|---|
.py | Python, prin uv inclus în Nebo, când există, altfel python3. |
.ts, .js | Bun inclus în Nebo, când există, altfel node. |
bin/<file> sau binary | Rulat direct. |
.sh | Nu este suportat. |
Fiecare rulare pornește cu un mediu gol și cu aceste variabile:
| Variabilă | Valoare |
|---|---|
SKILL_ARGS | Obiectul args ca JSON. |
Fiecare key de secret | Valoarea decriptată a secretului. |
<PLUGIN>_BIN | Calea binarului fiecărui plugin declarat. Folderele pluginurilor sunt adăugate și la 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", []))})) Scriptul rulează într-o copie temporară a folderului abilității, cu un timp de așteptare implicit de 30 de secunde. Pe macOS și Linux rulează într-un sandbox al sistemului de operare:
- Nu poate citi depozitele de date de acces, datele browserului și ale keychainului sau setările și baza de date proprii ale Nebo.
- Poate scrie doar în folderul său de lucru și în
/tmp/nebo. Capabilitateastorageadaugă folderul de date al Nebo. - Nu are acces la rețea. Capabilitatea
networkpermite registrele de pachete și domeniile listate înmetadata.allowed_domains.
Fișiere și limite
| Element | Regulă |
|---|---|
| Resurse | Fiecare fișier, cu excepția SKILL.md, manifest.json, signatures.json și a fișierelor care încep cu punct. |
| Executabile | Fișierele din scripts/ sau bin/ și un fișier rădăcină numit binary. |
| Căi | Relative la folderul abilității. Căile cu .. sau care ies din folder sunt respinse. |
| Abilitate dezactivată | Un folder cu SKILL.md.disabled în loc de SKILL.md. |
| Lista de abilități | Fiecare intrare este tăiată la 250 de caractere. Când întreaga listă depășește 8.000 de caractere, abilitățile comune sunt scurtate primele; abilitățile proprii ale unui angajat își păstrează intrările complete. |
Limitele pentru fișierele pe care le publici în magazin se află pe pagina Publicare.