Filformat
SKILL.md är UTF-8-text. Den börjar med en rad med tre bindestreck, sedan YAML-frontmatter och sedan en avslutande rad med tre bindestreck. Allt därefter är innehållet: Markdown-instruktioner som medarbetaren får när den laddar färdigheten. Nebo hittar filen via namnet oavsett skiftläge.
---
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 ... Frontmatter-fält
Bara name och description är obligatoriska. Ett fält med fel typ gör hela filen ogiltig, så färdigheten laddas inte. Nycklar som inte listas här ignoreras.
| Fält | Typ | Standard | Betydelse |
|---|---|---|---|
name | string | obligatoriskt | Identifierare. [a-z0-9-], inget inledande, avslutande eller dubbelt bindestreck, högst 64 byte. Ska matcha mappnamnet. |
description | string | obligatoriskt | Vad färdigheten gör och när den ska användas. Högst 1 024 byte. Visas i medarbetarens färdighetslista och poängsätts av find_skills. |
version | string | "1.0.0" | Semantisk version. Kontrolleras mot andra färdigheters requires-intervall. Sätt citattecken kring den. |
triggers | lista med strängar | [] | Ord och fraser som beskriver när färdigheten är aktuell. Upp till tre visas i färdighetslistan; alla räknas i find_skills. De laddar aldrig en färdighet på egen hand. |
platform | lista med strängar | alla | macos, linux, windows. Färdigheten laddas bara där någon matchar. |
capabilities | lista med strängar | [] | network och storage vidgar skriptsandlådan. Se Skriptsandlåda. |
metadata | map | {} | Innehåller secrets och allowed_domains. Se nedan. |
requires | lista med {name, version} | [] | Andra färdigheter som den här färdigheten bygger på. name är färdighetens korta namn; version är ett semver-intervall, standard "*". |
plugins | lista med {name, version, optional} | [] | Plugins som den här färdigheten använder. version är som standard "*", optional är false. |
dependencies | lista med strängar | [] | Korta namn på färdigheter som måste finnas. |
priority | integer | 0 | Ordnar färdigheter i hanteringslistor. Påverkar inte vilken färdighet en medarbetare väljer. |
author | string | "" | Lagras för visning. |
license | string | "" | Lagras för visning. |
compatibility | string | "" | Fritextanteckning, högst 500 byte. |
tags | lista med strängar | [] | Lagras för visning. |
allowed-tools | string | "" | En mellanslagsavgränsad sträng. Lagras; tillämpas inte. |
När en färdighet som anges i requires eller dependencies saknas eller ligger utanför intervallet, eller ett obligatoriskt plugin inte är installerat, laddas färdigheten ändå och markeras som nedsatt. Ägaren ser vad som saknas.
Hemligheter
Ange de inloggningsuppgifter som en färdighets skript behöver under metadata.secrets. Ägaren tillhandahåller värdena, och Nebo lagrar dem krypterade för den färdigheten.
metadata:
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true | Nyckel | Betydelse |
|---|---|
key | Namnet på miljövariabeln som skriptet får. Obligatoriskt. |
label | Namn som visas för ägaren. |
hint | Var värdet hämtas. |
required | När true vägrar execute att köra färdighetens skript tills värdet är angivet. Standard false. |
En medarbetare anger ett värde med configure_skill. Du kan referera till en hemlighet i brödtexten som ${secret.KEY}, men skript bör i stället läsa miljövariabeln.
Mallvariabler
Nebo ersätter de här variablerna i innehållet när en medarbetare laddar färdigheten. De ersätts inte i andra filer; skript läser miljövariabler i stället.
| Variabel | Värde |
|---|---|
${NEBO_SKILL_DIR} | Absolut sökväg till färdighetens mapp. |
${NEBO_DATA_DIR} | En skrivbar mapp för den här färdigheten: <data>/appdata/skills/<name>. Skapas vid första användningen. |
${NEBO_USER_NAME} | Ägarens namn. |
${NEBO_OS} | Operativsystemet. |
${NEBO_ARCH} | Processorarkitekturen. |
${plugin.SLUG_BIN} | Sökväg till ett angivet plugins binärfil. Slug-värdet skrivs med versaler och med bindestreck som understreck: example-ledger blir ${plugin.EXAMPLE_LEDGER_BIN}. |
${secret.KEY} | Värdet av en angiven hemlighet. |
$ARGUMENTS | De args som skickas till use_skill. När innehållet saknar $ARGUMENTS läggs argumenten till efter det. |
Färdighetsverktyg
Medarbetare arbetar med färdigheter via de här verktygen. use_skill är alltid tillgängligt; de andra laddas när en medarbetare behöver dem.
| Verktyg | Parametrar | Vad det gör |
|---|---|---|
use_skill | name, args | Laddar en färdighet. Returnerar det expanderade innehållet, mappens sökväg och de första 20 filnamnen. Aktiverar en avstängd färdighet igen. |
find_skills | query | Returnerar upp till 10 färdigheter rangordnade efter träffar på namn, utlösare och beskrivning. |
read_skill_file | name, path | Läser en fil i färdighetens mapp. Utan path listas filerna och deras storlekar. |
save_skill | name, content | Skriver en komplett SKILL.md till användarens färdighetsmapp. Färdigheter från marknadsplatsen kan inte skrivas över. |
delete_skill | name | Raderar en användarfärdighet. |
install_skill | code | Installerar en färdighet från marknadsplatsen med dess SKIL--installationskod. |
configure_skill | name, key, value | Anger en hemlighet. Utan key visas vad färdigheten behöver. |
rate_skill | name, rating, review | Betygsätter en färdighet på marknadsplatsen från 1 till 5. |
read_skill_reviews | name | Läser recensioner av en färdighet på marknadsplatsen. |
execute | skill, script, args, timeout | Kör ett skript från en färdighets mapp. Se Skriptsandlåda. |
Skriptsandlåda
Verktyget execute kör ett skript från en färdighets mapp. Det väljer körmiljö utifrån filen.
| Skript | Körmiljö |
|---|---|
.py | Python, via Nebos medföljande uv om den finns, annars python3. |
.ts, .js | Nebos medföljande Bun om den finns, annars node. |
bin/<file> eller binary | Körs direkt. |
.sh | Stöds inte. |
Varje körning startar med en tom miljö och de här variablerna:
| Variabel | Värde |
|---|---|
SKILL_ARGS | Objektet args som JSON. |
Varje hemlighets key | Det dekrypterade värdet av hemligheten. |
<PLUGIN>_BIN | Sökväg till varje angivet plugins binärfil. Pluginmappar läggs också till i 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", []))})) Skriptet körs i en tillfällig kopia av färdighetsmappen, med en standardtidsgräns på 30 sekunder. På macOS och Linux körs det i en sandlåda i operativsystemet:
- Det kan inte läsa lagringsplatser för inloggningsuppgifter, webbläsar- och nyckelringsdata eller Nebos egna inställningar och databas.
- Det kan bara skriva till sin arbetsmapp och
/tmp/nebo. Förmåganstoragelägger till Nebos datamapp. - Det har ingen nätverksåtkomst. Förmågan
networktillåter paketregister och domänerna som listas imetadata.allowed_domains.
Filer och gränser
| Objekt | Regel |
|---|---|
| Resurser | Alla filer utom SKILL.md, manifest.json, signatures.json och punktfiler. |
| Körbara filer | Filer under scripts/ eller bin/, och en fil i roten med namnet binary. |
| Sökvägar | Relativa till färdighetsmappen. Sökvägar med .. eller som tar sig ut ur mappen avvisas. |
| Avstängd färdighet | En mapp med SKILL.md.disabled i stället för SKILL.md. |
| Färdighetslista | Varje post kortas vid 250 tecken. När hela listan överstiger 8 000 tecken kortas delade färdigheter först; en medarbetares egna färdigheter behåller sina fullständiga poster. |
Gränserna för filer som du publicerar på marknadsplatsen finns på sidan Publicering.