NeboAI
NeboAI
Loslegen

SKILL.md-Referenz

Diese Seite listet jeden Teil eines Skills auf, den Nebo liest: die Frontmatter-Felder, die Variablen, die es ersetzt, die Tools, mit denen Mitarbeiter mit Skills arbeiten, und die Umgebung, in der Skripte laufen.

Dateiformat

SKILL.md ist UTF-8-Text. Die Datei beginnt mit einer Zeile aus drei Bindestrichen, dann folgt YAML-Frontmatter, dann eine abschließende Zeile aus drei Bindestrichen. Alles danach ist der Text: Markdown-Anweisungen, die der Mitarbeiter erhält, wenn er den Skill lädt. Nebo findet die Datei über ihren Namen, unabhängig von Groß- und Kleinschreibung.

---
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-Felder

Nur name und description sind Pflicht. Ein Feld mit falschem Typ lässt die ganze Datei scheitern, sodass der Skill nicht geladen wird. Hier nicht aufgeführte Schlüssel werden ignoriert.

FeldTypStandardBedeutung
namestringerforderlichBezeichner. [a-z0-9-], kein Bindestrich am Anfang, am Ende oder doppelt, höchstens 64 Bytes. Muss dem Ordnernamen entsprechen.
descriptionstringerforderlichWas der Skill tut und wann man ihn nutzt. Höchstens 1.024 Bytes. Wird in der Skill-Liste des Mitarbeiters angezeigt und von find_skills bewertet.
versionstring"1.0.0"Semantische Version. Wird gegen die requires-Bereiche anderer Skills geprüft. In Anführungszeichen setzen.
triggersListe von Strings[]Begriffe und Wendungen, die beschreiben, wann der Skill passt. Bis zu drei erscheinen in der Skill-Liste; alle zählen bei find_skills. Sie laden einen Skill nie von selbst.
platformListe von Stringsallemacos, linux, windows. Der Skill wird nur dort geladen, wo eines passt.
capabilitiesListe von Strings[]network und storage erweitern die Skript-Sandbox. Siehe Skript-Sandbox.
metadatamap{}Enthält secrets und allowed_domains. Siehe unten.
requiresListe von {name, version}[]Andere Skills, auf denen dieser Skill aufbaut. name ist der kurze Skill-Name; version ist ein Semver-Bereich, Standard "*".
pluginsListe von {name, version, optional}[]Plugins, die dieser Skill nutzt. version ist standardmäßig "*", optional standardmäßig false.
dependenciesListe von Strings[]Kurznamen von Skills, die vorhanden sein müssen.
priorityinteger0Ordnet Skills in Verwaltungslisten. Es beeinflusst nicht, welchen Skill ein Mitarbeiter wählt.
authorstring""Wird für die Anzeige gespeichert.
licensestring""Wird für die Anzeige gespeichert.
compatibilitystring""Freitextnotiz, höchstens 500 Bytes.
tagsListe von Strings[]Wird für die Anzeige gespeichert.
allowed-toolsstring""Ein durch Leerzeichen getrennter String. Wird gespeichert, aber nicht erzwungen.

Wenn ein in requires oder dependencies genannter Skill fehlt oder außerhalb des Bereichs liegt oder ein benötigtes Plugin nicht installiert ist, wird der Skill trotzdem geladen und als eingeschränkt markiert. Der Inhaber sieht, was fehlt.

Secrets

Deklariere die Zugangsdaten, die die Skripte eines Skills brauchen, unter metadata.secrets. Der Inhaber gibt die Werte an, und Nebo speichert sie verschlüsselt für diesen Skill.

metadata:
  secrets:
    - key: EXAMPLE_API_KEY
      label: Example API key
      hint: Create one at https://example.com/settings/keys
      required: true
SchlüsselBedeutung
keyName der Umgebungsvariablen, die das Skript erhält. Pflicht.
labelName, der dem Inhaber angezeigt wird.
hintWo man den Wert bekommt.
requiredBei true verweigert execute die Ausführung der Skripte des Skills, bis der Wert gesetzt ist. Standard false.

Ein Mitarbeiter setzt einen Wert mit configure_skill. Im Text kannst du ein Secret als ${secret.KEY} referenzieren, Skripte sollten aber stattdessen die Umgebungsvariable lesen.

Vorlagenvariablen

Nebo ersetzt diese Variablen im Text, wenn ein Mitarbeiter den Skill lädt. In anderen Dateien werden sie nicht ersetzt; Skripte lesen stattdessen Umgebungsvariablen.

VariableWert
${NEBO_SKILL_DIR}Absoluter Pfad des Skill-Ordners.
${NEBO_DATA_DIR}Ein beschreibbarer Ordner für diesen Skill: <data>/appdata/skills/<name>. Wird bei der ersten Nutzung angelegt.
${NEBO_USER_NAME}Der Name des Inhabers.
${NEBO_OS}Das Betriebssystem.
${NEBO_ARCH}Die Prozessorarchitektur.
${plugin.SLUG_BIN}Pfad der Binärdatei eines deklarierten Plugins. Der Slug wird in Großbuchstaben geschrieben, mit Unterstrichen statt Bindestrichen: Aus example-ledger wird ${plugin.EXAMPLE_LEDGER_BIN}.
${secret.KEY}Der Wert eines deklarierten Secrets.
$ARGUMENTSDie an use_skill übergebenen args. Enthält der Text kein $ARGUMENTS, werden die Argumente am Ende angehängt.

Skill-Tools

Mitarbeiter arbeiten über diese Tools mit Skills. use_skill ist immer verfügbar; die anderen werden geladen, wenn ein Mitarbeiter sie braucht.

ToolParameterFunktion
use_skillname, argsLädt einen Skill. Liefert den ersetzten Text, den Ordnerpfad und die ersten 20 Dateinamen. Aktiviert einen deaktivierten Skill wieder.
find_skillsqueryLiefert bis zu 10 Skills, sortiert nach Treffern in Name, Trigger und Beschreibung.
read_skill_filename, pathLiest eine Datei im Ordner des Skills. Ohne path werden die Dateien und ihre Größen aufgelistet.
save_skillname, contentSchreibt eine vollständige SKILL.md in den Benutzer-Skill-Ordner. Marktplatz-Skills können nicht überschrieben werden.
delete_skillnameLöscht einen Benutzer-Skill.
install_skillcodeInstalliert einen Marktplatz-Skill über seinen SKIL--Installationscode.
configure_skillname, key, valueSetzt ein Secret. Ohne key wird angezeigt, was der Skill braucht.
rate_skillname, rating, reviewBewertet einen Marktplatz-Skill mit 1 bis 5.
read_skill_reviewsnameLiest die Bewertungen eines Marktplatz-Skills.
executeskill, script, args, timeoutFührt ein Skript aus dem Ordner eines Skills aus. Siehe Skript-Sandbox.

Skript-Sandbox

Das Tool execute führt ein Skript aus dem Ordner eines Skills aus. Es wählt die Laufzeit anhand der Datei.

SkriptLaufzeit
.pyPython, über Nebos mitgeliefertes uv, falls vorhanden, sonst python3.
.ts, .jsNebos mitgeliefertes Bun, falls vorhanden, sonst node.
bin/<file> oder binaryWird direkt ausgeführt.
.shNicht unterstützt.

Jeder Lauf beginnt mit einer leeren Umgebung und diesen Variablen:

VariableWert
SKILL_ARGSDas args-Objekt als JSON.
Jeder Secret-keyDer entschlüsselte Wert des Secrets.
<PLUGIN>_BINPfad der Binärdatei jedes deklarierten Plugins. Plugin-Ordner werden außerdem zu PATH hinzugefügt.
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", []))}))

Das Skript läuft in einer temporären Kopie des Skill-Ordners, mit einem Standard-Timeout von 30 Sekunden. Unter macOS und Linux läuft es in einer Sandbox des Betriebssystems:

  • Es kann keine Zugangsdatenspeicher, Browser- und Schlüsselbunddaten oder Nebos eigene Einstellungen und Datenbank lesen.
  • Es kann nur in seinen Arbeitsordner und nach /tmp/nebo schreiben. Die Fähigkeit storage fügt Nebos Datenordner hinzu.
  • Es hat keinen Netzwerkzugriff. Die Fähigkeit network erlaubt Paket-Registries und die in metadata.allowed_domains aufgeführten Domains.

Dateien und Grenzen

ElementRegel
RessourcenJede Datei außer SKILL.md, manifest.json, signatures.json und Dotfiles.
Ausführbare DateienDateien unter scripts/ oder bin/ und eine Datei namens binary im Stammverzeichnis.
PfadeRelativ zum Skill-Ordner. Pfade mit .. oder solche, die den Ordner verlassen, werden abgelehnt.
Deaktivierter SkillEin Ordner mit SKILL.md.disabled statt SKILL.md.
Skill-ListeJeder Eintrag wird nach 250 Zeichen abgeschnitten. Wenn die ganze Liste 8.000 Zeichen überschreitet, werden zuerst gemeinsame Skills gekürzt; die eigenen Skills eines Mitarbeiters behalten ihre vollständigen Einträge.

Die Grenzen für Dateien, die du auf dem Marktplatz veröffentlichst, stehen auf der Seite Veröffentlichen.