NeboAI
NeboAI
Kom igång

SKILL.md-referens

Den här sidan listar varje del av en färdighet som Nebo läser: frontmatter-fälten, variablerna som expanderas, verktygen som medarbetare använder för att arbeta med färdigheter och miljön som skript körs i.

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ältTypStandardBetydelse
namestringobligatorisktIdentifierare. [a-z0-9-], inget inledande, avslutande eller dubbelt bindestreck, högst 64 byte. Ska matcha mappnamnet.
descriptionstringobligatorisktVad 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.
versionstring"1.0.0"Semantisk version. Kontrolleras mot andra färdigheters requires-intervall. Sätt citattecken kring den.
triggerslista 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.
platformlista med strängarallamacos, linux, windows. Färdigheten laddas bara där någon matchar.
capabilitieslista med strängar[]network och storage vidgar skriptsandlådan. Se Skriptsandlåda.
metadatamap{}Innehåller secrets och allowed_domains. Se nedan.
requireslista 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 "*".
pluginslista med {name, version, optional}[]Plugins som den här färdigheten använder. version är som standard "*", optional är false.
dependencieslista med strängar[]Korta namn på färdigheter som måste finnas.
priorityinteger0Ordnar färdigheter i hanteringslistor. Påverkar inte vilken färdighet en medarbetare väljer.
authorstring""Lagras för visning.
licensestring""Lagras för visning.
compatibilitystring""Fritextanteckning, högst 500 byte.
tagslista med strängar[]Lagras för visning.
allowed-toolsstring""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
NyckelBetydelse
keyNamnet på miljövariabeln som skriptet får. Obligatoriskt.
labelNamn som visas för ägaren.
hintVar värdet hämtas.
requiredNä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.

VariabelVä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.
$ARGUMENTSDe 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.

VerktygParametrarVad det gör
use_skillname, argsLaddar 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_skillsqueryReturnerar upp till 10 färdigheter rangordnade efter träffar på namn, utlösare och beskrivning.
read_skill_filename, pathLäser en fil i färdighetens mapp. Utan path listas filerna och deras storlekar.
save_skillname, contentSkriver en komplett SKILL.md till användarens färdighetsmapp. Färdigheter från marknadsplatsen kan inte skrivas över.
delete_skillnameRaderar en användarfärdighet.
install_skillcodeInstallerar en färdighet från marknadsplatsen med dess SKIL--installationskod.
configure_skillname, key, valueAnger en hemlighet. Utan key visas vad färdigheten behöver.
rate_skillname, rating, reviewBetygsätter en färdighet på marknadsplatsen från 1 till 5.
read_skill_reviewsnameLäser recensioner av en färdighet på marknadsplatsen.
executeskill, script, args, timeoutKö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.

SkriptKörmiljö
.pyPython, via Nebos medföljande uv om den finns, annars python3.
.ts, .jsNebos medföljande Bun om den finns, annars node.
bin/<file> eller binaryKörs direkt.
.shStöds inte.

Varje körning startar med en tom miljö och de här variablerna:

VariabelVärde
SKILL_ARGSObjektet args som JSON.
Varje hemlighets keyDet dekrypterade värdet av hemligheten.
<PLUGIN>_BINSö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ågan storage lägger till Nebos datamapp.
  • Det har ingen nätverksåtkomst. Förmågan network tillåter paketregister och domänerna som listas i metadata.allowed_domains.

Filer och gränser

ObjektRegel
ResurserAlla filer utom SKILL.md, manifest.json, signatures.json och punktfiler.
Körbara filerFiler under scripts/ eller bin/, och en fil i roten med namnet binary.
SökvägarRelativa till färdighetsmappen. Sökvägar med .. eller som tar sig ut ur mappen avvisas.
Avstängd färdighetEn mapp med SKILL.md.disabled i stället för SKILL.md.
FärdighetslistaVarje 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.