NeboAI
NeboAI
Loslegen

Skills

Ein Skill bringt einem Mitarbeiter bei, eine bestimmte Art von Arbeit gut zu erledigen. Du schreibst ihn als Ordner mit einer SKILL.md-Datei: eine kurze Beschreibung, anhand derer der Mitarbeiter den Skill auswählt, und Anweisungen, denen er folgt, sobald der Skill geladen ist. Skills brauchen keinen Code, und jeder Mitarbeiter auf einem Bot kann sie nutzen.

Was ein Skill ist

Ein Skill ist ein Ordner, dessen Name dem name des Skills entspricht. Der Ordner enthält eine SKILL.md-Datei und optional weitere Dateien, auf die sich die Anweisungen beziehen: Referenzdokumente, Vorlagen oder Skripte.

SKILL.md besteht aus zwei Teilen. YAML-Frontmatter zwischen ----Zeilen enthält den Namen und eine Beschreibung. Der Markdown-Text danach enthält die Anweisungen.

Wie Mitarbeiter Skills nutzen

Ein Mitarbeiter arbeitet in drei Schritten mit einem Skill.

  1. Auswählen. In jedem Durchgang sieht der Mitarbeiter eine Liste der für ihn verfügbaren Skills: den Namen jedes Skills, seine Beschreibung und bis zu drei seiner Trigger. Die Beschreibung ist das, was der Mitarbeiter liest, um sich zu entscheiden, also schreib darin, was der Skill tut und wann man ihn nutzt.
  2. Laden. Der Mitarbeiter ruft das Tool use_skill mit dem Namen des Skills auf. Das Tool liefert die Anweisungen, den Pfad des Skill-Ordners und die Namen seiner Dateien zurück. Nur so liest ein Mitarbeiter einen Skill.
  3. Arbeiten. Der Mitarbeiter folgt den Anweisungen. Er liest ergänzende Dateien mit read_skill_file und führt mitgelieferte Skripte mit execute aus.

Trigger laden einen Skill nie von selbst. Die Wahl trifft immer der Mitarbeiter. Wenn die Liste lang wird, kann der Mitarbeiter sie mit find_skills durchsuchen.

Deinen ersten Skill schreiben

Erstelle einen Ordner, der nach dem Skill benannt ist, mit einer Datei darin.

meeting-notes/
└── SKILL.md
---
name: meeting-notes
description: Turn a meeting transcript into decisions, action items with owners, and open questions. Use when someone shares meeting notes or a transcript.
---

# Meeting notes

1. List the decisions that were made.
2. List action items as "owner — task — due date".
3. List open questions that need a follow-up.

Keep each list short. If the transcript names no owner for an item, write "unassigned".

Lege den Ordner in das Benutzer-Skill-Verzeichnis eines Bots (siehe Wo Skills liegen). Nebo bemerkt den neuen Ordner innerhalb von etwa einer Sekunde, und jeder Mitarbeiter auf diesem Bot kann den Skill nutzen.

Ein Mitarbeiter kann auch einen Skill für dich schreiben. Bitte ihn, einen zu speichern, und er ruft save_skill auf, das den Ordner in dasselbe Benutzer-Skill-Verzeichnis schreibt.

Regeln, die der Loader durchsetzt

Ein Skill, der gegen eine dieser Regeln verstößt, wird nicht geladen. Nebo protokolliert eine Warnung und überspringt ihn.

RegelDetail
Datei beginnt mit ---Das Frontmatter muss ganz am Anfang der Datei stehen. Die Datei muss UTF-8 sein.
name ist PflichtNur Kleinbuchstaben, Ziffern und Bindestriche; kein Bindestrich am Anfang oder Ende; kein doppelter Bindestrich; höchstens 64 Bytes.
description ist PflichtHöchstens 1.024 Bytes.
Felder haben den richtigen TypEin Feld mit falschem YAML-Typ lässt die ganze Datei scheitern. Setze Versionen in Anführungszeichen, etwa "1.0.0".
platform passtFalls vorhanden, wird der Skill nur auf den aufgeführten Betriebssystemen geladen.

Frontmatter-Schlüssel, die Nebo nicht kennt, werden ignoriert. Der Text hat keine Größenbegrenzung, aber kürzere Anweisungen lassen mehr Raum für die Arbeit. Verschiebe lange Inhalte in Dateien, die der Mitarbeiter liest, wenn er sie braucht.

Dateien hinzufügen

Jede Datei im Ordner außer SKILL.md und Dotfiles steht dem Mitarbeiter zur Verfügung. Ordnernamen wählst du selbst; Nebo gibt references/ oder assets/ keine besondere Bedeutung. Dateien unter scripts/ oder bin/ können ausgeführt werden.

invoice-check/
├── SKILL.md              # required
├── references/
│   └── policy.md         # read with read_skill_file
└── scripts/
    └── totals.py         # run with execute

Verweise auf Dateien über ihren Pfad innerhalb des Ordners, etwa references/policy.md. Der Mitarbeiter liest sie mit read_skill_file, das jeden Pfad ablehnt, der den Ordner verlässt. Skripte laufen mit dem Tool execute in einer Sandbox. Die SKILL.md-Referenz behandelt Laufzeiten, Umgebungsvariablen, Secrets und Netzwerkzugriff.

Wo Skills liegen

Ein Bot sammelt Skills aus mehreren Quellen. Wenn zwei Quellen einen Skill mit demselben Namen liefern, gewinnt die spätere Quelle in dieser Liste.

QuelleOrtWer ihn nutzen kann
IntegriertIn Nebo einkompiliertJeder Mitarbeiter
Marktplatz<data>/nebo/skills/<slug>/<version>/Jeder Mitarbeiter
PluginDer Ordner skills/ eines installierten PluginsJeder Mitarbeiter
Benutzer<data>/user/skills/<name>/Jeder Mitarbeiter
Mitarbeiterpaketskills/ in einem installierten MitarbeiterpaketNur dieser Mitarbeiter
Gelernt<data>/learned/skills/<employee>/<name>/Nur dieser Mitarbeiter

<data> ist ~/Library/Application Support/Nebo unter macOS, %APPDATA%\Nebo unter Windows und ~/.local/share/nebo unter Linux. Die Umgebungsvariable NEBO_HOME überschreibt das. Wenn ein Mitarbeiter einen eigenen Skill und einen gemeinsamen Skill mit demselben Namen hat, gewinnt sein eigener Skill.

Nebo überwacht diese Ordner und lädt einen geänderten Skill nach einer Sekunde neu. Um einen Skill abzuschalten, ohne ihn zu löschen, benenne seine Datei in SKILL.md.disabled um.

Skills beschreiben Arbeit, keine Tools. Schreib einen Skill rund um eine Aufgabe, etwa den Abgleich von Belegen, und lass den Mitarbeiter die Verbindung nutzen, die der Inhaber bereitgestellt hat. Wenn ein Skill wirklich ein Plugin braucht, deklariere es im Feld plugins.

Weiter