Wat een skill is
Een skill is een map waarvan de naam overeenkomt met de name van de skill. De map bevat een SKILL.md-bestand en eventueel andere bestanden waarnaar de instructies verwijzen: naslagdocumenten, sjablonen of scripts.
SKILL.md bestaat uit twee delen. YAML-frontmatter tussen regels met --- bevat de naam en een beschrijving. De Markdown-body daarna bevat de instructies.
Zo gebruiken medewerkers skills
Een medewerker werkt in drie stappen met een skill.
- Kiezen. Bij elke beurt ziet de medewerker een lijst met de skills die voor hem beschikbaar zijn: de naam van elke skill, de beschrijving en maximaal drie van de triggers. De beschrijving is wat de medewerker leest om te beslissen, dus schrijf erin wat de skill doet en wanneer je hem gebruikt.
- Laden. De medewerker roept de tool
use_skillaan met de naam van de skill. De tool geeft de instructies terug, het pad van de map van de skill en de namen van de bestanden. Dit is de enige manier waarop een medewerker een skill leest. - Werken. De medewerker volgt de instructies. Hij leest ondersteunende bestanden met
read_skill_fileen voert meegeleverde scripts uit metexecute.
Triggers laden nooit zelf een skill. De medewerker maakt altijd de keuze. Als de lijst lang wordt, kan de medewerker erin zoeken met find_skills.
Schrijf je eerste skill
Maak een map met de naam van de skill, met één bestand erin.
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".
Zet de map in de map met gebruikersskills van een bot (zie Waar skills staan). Nebo merkt de nieuwe map binnen ongeveer een seconde op, en elke medewerker op die bot kan de skill gebruiken.
Een medewerker kan ook een skill voor je schrijven. Vraag hem er een op te slaan, dan roept hij save_skill aan, dat de map in dezelfde map met gebruikersskills schrijft.
Regels die de loader afdwingt
Een skill die een van deze regels overtreedt, laadt niet. Nebo logt een waarschuwing en slaat hem over.
| Regel | Detail |
|---|---|
Bestand begint met --- | De frontmatter moet het eerste in het bestand zijn. Het bestand moet UTF-8 zijn. |
name is verplicht | Alleen kleine letters, cijfers en koppeltekens; geen koppelteken aan het begin of eind; geen dubbel koppelteken; maximaal 64 bytes. |
description is verplicht | Maximaal 1.024 bytes. |
| Velden hebben het juiste type | Een veld met het verkeerde YAML-type laat het hele bestand mislukken. Zet versies tussen aanhalingstekens, zoals "1.0.0". |
platform komt overeen | Indien aanwezig laadt de skill alleen op de genoemde besturingssystemen. |
Frontmattersleutels die Nebo niet herkent, worden genegeerd. De body heeft geen maximale grootte, maar kortere instructies laten meer ruimte voor het werk. Zet lang materiaal in bestanden die de medewerker leest wanneer hij ze nodig heeft.
Bestanden toevoegen
Elk bestand in de map behalve SKILL.md en dotfiles is beschikbaar voor de medewerker. Mapnamen kies je zelf; Nebo geeft geen speciale betekenis aan references/ of assets/. Bestanden onder scripts/ of bin/ kunnen worden uitgevoerd.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Verwijs naar bestanden met hun pad binnen de map, zoals references/policy.md. De medewerker leest ze met read_skill_file, dat elk pad weigert dat buiten de map gaat. Scripts draaien met de tool execute in een sandbox. De naslag voor SKILL.md behandelt runtimes, omgevingsvariabelen, geheimen en netwerktoegang.
Waar skills staan
Een bot verzamelt skills van verschillende plekken. Als twee bronnen een skill met dezelfde naam leveren, wint de bron die later in deze lijst staat.
| Bron | Locatie | Wie hem kan gebruiken |
|---|---|---|
| Ingebouwd | Ingebouwd in Nebo | Elke medewerker |
| Marktplaats | <data>/nebo/skills/<slug>/<version>/ | Elke medewerker |
| Plugin | De map skills/ van een geïnstalleerde plugin | Elke medewerker |
| Gebruiker | <data>/user/skills/<name>/ | Elke medewerker |
| Medewerkerspakket | skills/ in een geïnstalleerd medewerkerspakket | Alleen die medewerker |
| Geleerd | <data>/learned/skills/<employee>/<name>/ | Alleen die medewerker |
<data> is ~/Library/Application Support/Nebo op macOS, %APPDATA%\Nebo op Windows en ~/.local/share/nebo op Linux. De omgevingsvariabele NEBO_HOME overschrijft dit. Als een medewerker een eigen skill en een gedeelde skill met dezelfde naam heeft, wint zijn eigen skill.
Nebo houdt deze mappen in de gaten en laadt een gewijzigde skill na één seconde opnieuw. Om een skill uit te zetten zonder hem te verwijderen, hernoem je het bestand naar SKILL.md.disabled.
Skills beschrijven werk, geen tools. Schrijf een skill rond een verantwoordelijkheid, zoals bonnetjes afstemmen, en laat de medewerker de verbinding gebruiken die de eigenaar heeft geregeld. Als een skill echt een plugin nodig heeft, declareer die dan met het veld plugins.
Volgende
- Naslag voor SKILL.md: elk veld, elke tool en elke variabele.
- Voorbeelden: complete skills om te kopiëren.
- Publiceren: zet een skill op de marktplaats.