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.
- 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.
- Laden. Der Mitarbeiter ruft das Tool
use_skillmit 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. - Arbeiten. Der Mitarbeiter folgt den Anweisungen. Er liest ergänzende Dateien mit
read_skill_fileund führt mitgelieferte Skripte mitexecuteaus.
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.
| Regel | Detail |
|---|---|
Datei beginnt mit --- | Das Frontmatter muss ganz am Anfang der Datei stehen. Die Datei muss UTF-8 sein. |
name ist Pflicht | Nur Kleinbuchstaben, Ziffern und Bindestriche; kein Bindestrich am Anfang oder Ende; kein doppelter Bindestrich; höchstens 64 Bytes. |
description ist Pflicht | Höchstens 1.024 Bytes. |
| Felder haben den richtigen Typ | Ein Feld mit falschem YAML-Typ lässt die ganze Datei scheitern. Setze Versionen in Anführungszeichen, etwa "1.0.0". |
platform passt | Falls 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.
| Quelle | Ort | Wer ihn nutzen kann |
|---|---|---|
| Integriert | In Nebo einkompiliert | Jeder Mitarbeiter |
| Marktplatz | <data>/nebo/skills/<slug>/<version>/ | Jeder Mitarbeiter |
| Plugin | Der Ordner skills/ eines installierten Plugins | Jeder Mitarbeiter |
| Benutzer | <data>/user/skills/<name>/ | Jeder Mitarbeiter |
| Mitarbeiterpaket | skills/ in einem installierten Mitarbeiterpaket | Nur 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
- SKILL.md-Referenz: jedes Feld, jedes Tool und jede Variable.
- Beispiele: vollständige Skills zum Kopieren.
- Veröffentlichen: einen Skill auf den Marktplatz bringen.