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.
| Feld | Typ | Standard | Bedeutung |
|---|---|---|---|
name | string | erforderlich | Bezeichner. [a-z0-9-], kein Bindestrich am Anfang, am Ende oder doppelt, höchstens 64 Bytes. Muss dem Ordnernamen entsprechen. |
description | string | erforderlich | Was 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. |
version | string | "1.0.0" | Semantische Version. Wird gegen die requires-Bereiche anderer Skills geprüft. In Anführungszeichen setzen. |
triggers | Liste 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. |
platform | Liste von Strings | alle | macos, linux, windows. Der Skill wird nur dort geladen, wo eines passt. |
capabilities | Liste von Strings | [] | network und storage erweitern die Skript-Sandbox. Siehe Skript-Sandbox. |
metadata | map | {} | Enthält secrets und allowed_domains. Siehe unten. |
requires | Liste von {name, version} | [] | Andere Skills, auf denen dieser Skill aufbaut. name ist der kurze Skill-Name; version ist ein Semver-Bereich, Standard "*". |
plugins | Liste von {name, version, optional} | [] | Plugins, die dieser Skill nutzt. version ist standardmäßig "*", optional standardmäßig false. |
dependencies | Liste von Strings | [] | Kurznamen von Skills, die vorhanden sein müssen. |
priority | integer | 0 | Ordnet Skills in Verwaltungslisten. Es beeinflusst nicht, welchen Skill ein Mitarbeiter wählt. |
author | string | "" | Wird für die Anzeige gespeichert. |
license | string | "" | Wird für die Anzeige gespeichert. |
compatibility | string | "" | Freitextnotiz, höchstens 500 Bytes. |
tags | Liste von Strings | [] | Wird für die Anzeige gespeichert. |
allowed-tools | string | "" | 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üssel | Bedeutung |
|---|---|
key | Name der Umgebungsvariablen, die das Skript erhält. Pflicht. |
label | Name, der dem Inhaber angezeigt wird. |
hint | Wo man den Wert bekommt. |
required | Bei 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.
| Variable | Wert |
|---|---|
${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. |
$ARGUMENTS | Die 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.
| Tool | Parameter | Funktion |
|---|---|---|
use_skill | name, args | Lädt einen Skill. Liefert den ersetzten Text, den Ordnerpfad und die ersten 20 Dateinamen. Aktiviert einen deaktivierten Skill wieder. |
find_skills | query | Liefert bis zu 10 Skills, sortiert nach Treffern in Name, Trigger und Beschreibung. |
read_skill_file | name, path | Liest eine Datei im Ordner des Skills. Ohne path werden die Dateien und ihre Größen aufgelistet. |
save_skill | name, content | Schreibt eine vollständige SKILL.md in den Benutzer-Skill-Ordner. Marktplatz-Skills können nicht überschrieben werden. |
delete_skill | name | Löscht einen Benutzer-Skill. |
install_skill | code | Installiert einen Marktplatz-Skill über seinen SKIL--Installationscode. |
configure_skill | name, key, value | Setzt ein Secret. Ohne key wird angezeigt, was der Skill braucht. |
rate_skill | name, rating, review | Bewertet einen Marktplatz-Skill mit 1 bis 5. |
read_skill_reviews | name | Liest die Bewertungen eines Marktplatz-Skills. |
execute | skill, script, args, timeout | Fü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.
| Skript | Laufzeit |
|---|---|
.py | Python, über Nebos mitgeliefertes uv, falls vorhanden, sonst python3. |
.ts, .js | Nebos mitgeliefertes Bun, falls vorhanden, sonst node. |
bin/<file> oder binary | Wird direkt ausgeführt. |
.sh | Nicht unterstützt. |
Jeder Lauf beginnt mit einer leeren Umgebung und diesen Variablen:
| Variable | Wert |
|---|---|
SKILL_ARGS | Das args-Objekt als JSON. |
Jeder Secret-key | Der entschlüsselte Wert des Secrets. |
<PLUGIN>_BIN | Pfad 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/neboschreiben. Die Fähigkeitstoragefügt Nebos Datenordner hinzu. - Es hat keinen Netzwerkzugriff. Die Fähigkeit
networkerlaubt Paket-Registries und die inmetadata.allowed_domainsaufgeführten Domains.
Dateien und Grenzen
| Element | Regel |
|---|---|
| Ressourcen | Jede Datei außer SKILL.md, manifest.json, signatures.json und Dotfiles. |
| Ausführbare Dateien | Dateien unter scripts/ oder bin/ und eine Datei namens binary im Stammverzeichnis. |
| Pfade | Relativ zum Skill-Ordner. Pfade mit .. oder solche, die den Ordner verlassen, werden abgelehnt. |
| Deaktivierter Skill | Ein Ordner mit SKILL.md.disabled statt SKILL.md. |
| Skill-Liste | Jeder 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.