NeboAI
NeboAI
Aan de slag

Skills

Een skill leert een medewerker hoe hij één soort werk goed doet. Je schrijft hem als map met een SKILL.md-bestand: een korte beschrijving waarmee de medewerker de skill kiest, en instructies die hij volgt zodra de skill is geladen. Skills hebben geen code nodig, en elke medewerker op een bot kan ze gebruiken.

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.

  1. 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.
  2. Laden. De medewerker roept de tool use_skill aan 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.
  3. Werken. De medewerker volgt de instructies. Hij leest ondersteunende bestanden met read_skill_file en voert meegeleverde scripts uit met execute.

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.

RegelDetail
Bestand begint met ---De frontmatter moet het eerste in het bestand zijn. Het bestand moet UTF-8 zijn.
name is verplichtAlleen kleine letters, cijfers en koppeltekens; geen koppelteken aan het begin of eind; geen dubbel koppelteken; maximaal 64 bytes.
description is verplichtMaximaal 1.024 bytes.
Velden hebben het juiste typeEen veld met het verkeerde YAML-type laat het hele bestand mislukken. Zet versies tussen aanhalingstekens, zoals "1.0.0".
platform komt overeenIndien 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.

BronLocatieWie hem kan gebruiken
IngebouwdIngebouwd in NeboElke medewerker
Marktplaats<data>/nebo/skills/<slug>/<version>/Elke medewerker
PluginDe map skills/ van een geïnstalleerde pluginElke medewerker
Gebruiker<data>/user/skills/<name>/Elke medewerker
Medewerkerspakketskills/ in een geïnstalleerd medewerkerspakketAlleen 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