Format ng file
Ang SKILL.md ay UTF-8 na text. Nagsisimula ito sa linya ng tatlong gitling, saka YAML frontmatter, saka isang pansarang linya ng tatlong gitling. Lahat ng kasunod niyon ay ang body: mga Markdown instruction na natatanggap ng empleyado kapag nilo-load nito ang skill. Hinahanap ng Nebo ang file ayon sa pangalan nang hindi pinapansin ang laki ng titik.
---
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 ... Mga frontmatter field
Ang name at description lang ang kailangan. Ang field na mali ang uri ay nagpapapalya sa buong file, kaya hindi nilo-load ang skill. Binabalewala ang mga key na hindi nakalista rito.
| Field | Uri | Default | Kahulugan |
|---|---|---|---|
name | string | kailangan | Identifier. [a-z0-9-], walang gitling sa simula, sa dulo o magkasunod, hanggang 64 bytes. Itugma sa pangalan ng folder. |
description | string | kailangan | Kung ano ang ginagawa ng skill at kailan ito gagamitin. Hanggang 1,024 bytes. Ipinapakita sa listahan ng skill ng empleyado at binibigyan ng score ng find_skills. |
version | string | "1.0.0" | Semantic version. Sinusuri ng mga requires range ng ibang skill. Lagyan ito ng quote. |
triggers | listahan ng mga string | [] | Mga salita at parirala na naglalarawan kung kailan angkop ang skill. Hanggang tatlo ang lumalabas sa listahan ng skill; lahat ay binibilang sa find_skills. Hindi nila kailanman nilo-load ang skill nang mag-isa. |
platform | listahan ng mga string | lahat | macos, linux, windows. Nilo-load lang ang skill kung saan may tumutugma. |
capabilities | listahan ng mga string | [] | Pinalalawak ng network at storage ang script sandbox. Tingnan ang Sandbox ng script. |
metadata | map | {} | Naglalaman ng secrets at allowed_domains. Tingnan sa ibaba. |
requires | listahan ng {name, version} | [] | Iba pang skill na pinagbabatayan ng skill na ito. Ang name ay ang maikling pangalan ng skill; ang version ay isang semver range, default na "*". |
plugins | listahan ng {name, version, optional} | [] | Mga plugin na ginagamit ng skill na ito. Default ng version ang "*", ng optional ang false. |
dependencies | listahan ng mga string | [] | Mga maikling pangalan ng mga skill na dapat naroon. |
priority | integer | 0 | Nag-aayos ng mga skill sa mga management list. Hindi nito naaapektuhan kung aling skill ang pipiliin ng empleyado. |
author | string | "" | Itinatago para sa display. |
license | string | "" | Itinatago para sa display. |
compatibility | string | "" | Malayang tala, hanggang 500 bytes. |
tags | listahan ng mga string | [] | Itinatago para sa display. |
allowed-tools | string | "" | Isang string na pinaghihiwalay ng space. Itinatago; hindi ipinapatupad. |
Kapag nawawala o labas sa range ang isang skill na binanggit sa requires o dependencies, o hindi naka-install ang isang kailangang plugin, nilo-load pa rin ang skill at minamarkahang degraded. Nakikita ng may-ari kung ano ang kulang.
Mga secret
Ideklara ang mga credential na kailangan ng mga script ng skill sa ilalim ng metadata.secrets. Ang may-ari ang nagbibigay ng mga value, at iniimbak ito ng Nebo nang naka-encrypt para sa skill na iyon.
metadata:
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true | Key | Kahulugan |
|---|---|
key | Pangalan ng environment variable na natatanggap ng script. Kailangan. |
label | Pangalang ipinapakita sa may-ari. |
hint | Kung saan kukunin ang value. |
required | Kapag true, tumatanggi ang execute na patakbuhin ang mga script ng skill hangga't hindi naitatakda ang value. Default ay false. |
Nagtatakda ang empleyado ng value gamit ang configure_skill. Puwede kang tumukoy ng secret sa body bilang ${secret.KEY}, pero dapat basahin ng mga script ang environment variable sa halip.
Mga template variable
Pinapalitan ng Nebo ang mga variable na ito sa body kapag nilo-load ng empleyado ang skill. Hindi sila pinapalitan sa loob ng ibang file; environment variable ang binabasa ng mga script.
| Variable | Value |
|---|---|
${NEBO_SKILL_DIR} | Absolute path ng folder ng skill. |
${NEBO_DATA_DIR} | Isang folder na masusulatan para sa skill na ito: <data>/appdata/skills/<name>. Ginagawa sa unang paggamit. |
${NEBO_USER_NAME} | Ang pangalan ng may-ari. |
${NEBO_OS} | Ang operating system. |
${NEBO_ARCH} | Ang architecture ng processor. |
${plugin.SLUG_BIN} | Path ng binary ng isang idineklarang plugin. Ginagawang uppercase ang slug, at ginagawang underscore ang mga gitling: nagiging ${plugin.EXAMPLE_LEDGER_BIN} ang example-ledger. |
${secret.KEY} | Ang value ng isang idineklarang secret. |
$ARGUMENTS | Ang args na ipinasa sa use_skill. Kapag walang $ARGUMENTS ang body, idinudugtong ang mga argument pagkatapos nito. |
Mga skill tool
Gumagana ang mga empleyado sa mga skill sa pamamagitan ng mga tool na ito. Laging available ang use_skill; nilo-load ang iba kapag kailangan ng empleyado.
| Tool | Mga parameter | Ginagawa nito |
|---|---|---|
use_skill | name, args | Nilo-load ang isang skill. Ibinabalik ang pinalawak na body, ang path ng folder, at ang unang 20 pangalan ng file. Ine-enable ulit ang naka-disable na skill. |
find_skills | query | Nagbabalik ng hanggang 10 skill na niraranggo ayon sa tugma sa pangalan, trigger at description. |
read_skill_file | name, path | Binabasa ang isang file sa folder ng skill. Kapag walang path, inililista ang mga file at ang laki nila. |
save_skill | name, content | Isinusulat ang kumpletong SKILL.md sa user skills folder. Hindi mapapatungan ang mga marketplace skill. |
delete_skill | name | Binubura ang isang user skill. |
install_skill | code | Ini-install ang isang marketplace skill mula sa SKIL- install code nito. |
configure_skill | name, key, value | Nagtatakda ng secret. Kapag walang key, ipinapakita kung ano ang kailangan ng skill. |
rate_skill | name, rating, review | Nire-rate ang isang marketplace skill mula 1 hanggang 5. |
read_skill_reviews | name | Binabasa ang mga review ng isang marketplace skill. |
execute | skill, script, args, timeout | Nagpapatakbo ng script mula sa folder ng skill. Tingnan ang Sandbox ng script. |
Sandbox ng script
Pinapatakbo ng tool na execute ang isang script mula sa folder ng skill. Pinipili nito ang runtime batay sa file.
| Script | Runtime |
|---|---|
.py | Python, sa pamamagitan ng kasamang uv ng Nebo kapag naroon, kung hindi ay python3. |
.ts, .js | Ang kasamang Bun ng Nebo kapag naroon, kung hindi ay node. |
bin/<file> o binary | Direktang pinapatakbo. |
.sh | Hindi sinusuportahan. |
Nagsisimula ang bawat run sa blangkong environment at sa mga variable na ito:
| Variable | Value |
|---|---|
SKILL_ARGS | Ang object na args bilang JSON. |
Bawat key ng secret | Ang na-decrypt na value ng secret. |
<PLUGIN>_BIN | Path ng binary ng bawat idineklarang plugin. Idinadagdag din sa PATH ang mga folder ng plugin. |
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", []))})) Tumatakbo ang script sa pansamantalang kopya ng folder ng skill, na may default na timeout na 30 segundo. Sa macOS at Linux, tumatakbo ito sa sandbox ng operating system:
- Hindi nito mababasa ang mga credential store, data ng browser at keychain, o ang sariling settings at database ng Nebo.
- Sa working folder nito at sa
/tmp/nebolang ito makakasulat. Idinadagdag ng capability nastorageang data folder ng Nebo. - Wala itong network access. Pinapayagan ng capability na
networkang mga package registry at ang mga domain na nakalista sametadata.allowed_domains.
Mga file at limit
| Item | Patakaran |
|---|---|
| Mga resource | Bawat file maliban sa SKILL.md, manifest.json, signatures.json at mga dotfile. |
| Mga executable | Mga file sa ilalim ng scripts/ o bin/, at isang root file na pinangalanang binary. |
| Mga path | Relative sa folder ng skill. Tinatanggihan ang mga path na may .. o lumalabas sa folder. |
| Naka-disable na skill | Isang folder na may SKILL.md.disabled sa halip na SKILL.md. |
| Listahan ng skill | Pinuputol sa 250 character ang bawat entry. Kapag lumampas sa 8,000 character ang buong listahan, ang mga shared na skill ang unang pinaiikli; buo pa rin ang entry ng sariling mga skill ng empleyado. |
Nasa page na Publishing ang mga limit para sa mga file na pina-publish mo sa marketplace.