NeboAI
NeboAI
Commencer

Skills

Un skill apprend à un employé à bien faire un type de travail. Vous le rédigez sous forme de dossier contenant un fichier SKILL.md : une courte description dont l'employé se sert pour choisir le skill, et les instructions qu'il suit une fois le skill chargé. Les skills ne nécessitent aucun code, et tous les employés d'un bot peuvent les utiliser.

Qu’est-ce qu’un skill

Un skill est un dossier dont le nom correspond au name du skill. Le dossier contient un fichier SKILL.md et, éventuellement, tout autre fichier auquel les instructions font référence : documents de référence, modèles ou scripts.

SKILL.md comporte deux parties. Le frontmatter YAML entre les lignes --- contient le nom et une description. Le corps Markdown qui suit contient les instructions.

Comment les employés utilisent les skills

Un employé travaille avec un skill en trois étapes.

  1. Choisir. À chaque tour, l'employé voit la liste des skills à sa disposition : le nom de chaque skill, sa description et jusqu'à trois de ses déclencheurs. C'est la description que l'employé lit pour décider : rédigez-la pour dire ce que fait le skill et quand l'utiliser.
  2. Charger. L'employé appelle l'outil use_skill avec le nom du skill. L'outil renvoie les instructions, le chemin du dossier du skill et les noms de ses fichiers. C'est la seule façon pour un employé de lire un skill.
  3. Travailler. L'employé suit les instructions. Il lit les fichiers annexes avec read_skill_file et exécute les scripts fournis avec execute.

Les déclencheurs ne chargent jamais un skill d'eux-mêmes. C'est toujours l'employé qui choisit. Quand la liste s'allonge, l'employé peut y chercher avec find_skills.

Rédiger votre premier skill

Créez un dossier portant le nom du skill, contenant un seul fichier.

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".

Placez le dossier dans le dossier des skills utilisateur d'un bot (voir Où se trouvent les skills). Nebo repère le nouveau dossier en une seconde environ, et tous les employés de ce bot peuvent utiliser le skill.

Un employé peut aussi rédiger un skill pour vous. Demandez-lui d'en enregistrer un : il appelle save_skill, qui écrit le dossier dans ce même dossier des skills utilisateur.

Règles appliquées par le chargeur

Un skill qui enfreint l'une de ces règles ne se charge pas. Nebo consigne un avertissement et l'ignore.

RègleDétail
Le fichier commence par ---Le frontmatter doit figurer en tout début de fichier. Le fichier doit être en UTF-8.
name est obligatoireLettres minuscules, chiffres et traits d’union uniquement ; pas de trait d’union au début ni à la fin ; pas de double trait d’union ; 64 octets au maximum.
description est obligatoire1 024 octets au maximum.
Les champs ont le bon typeUn champ avec un mauvais type YAML fait échouer tout le fichier. Mettez les versions entre guillemets, par exemple "1.0.0".
platform correspondS’il est présent, le skill ne se charge que sur les systèmes d’exploitation listés.

Les clés de frontmatter que Nebo ne reconnaît pas sont ignorées. Le corps n'a pas de limite de taille, mais des instructions plus courtes laissent plus de place au travail. Déplacez les contenus longs dans des fichiers que l'employé lit quand il en a besoin.

Ajouter des fichiers

Tout fichier du dossier autre que SKILL.md et les fichiers cachés est accessible à l'employé. Les noms de dossiers sont libres ; Nebo ne donne aucun sens particulier à references/ ou assets/. Les fichiers placés sous scripts/ ou bin/ peuvent être exécutés.

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

Désignez les fichiers par leur chemin dans le dossier, par exemple references/policy.md. L'employé les lit avec read_skill_file, qui refuse tout chemin sortant du dossier. Les scripts s'exécutent avec l'outil execute dans un bac à sable. La référence de SKILL.md couvre les environnements d'exécution, les variables d'environnement, les secrets et l'accès au réseau.

Où se trouvent les skills

Un bot rassemble des skills depuis plusieurs endroits. Quand deux sources fournissent un skill du même nom, c'est la source placée le plus bas dans cette liste qui l'emporte.

SourceEmplacementQui peut l’utiliser
IntégréCompilé dans NeboTous les employés
Boutique<data>/nebo/skills/<slug>/<version>/Tous les employés
PluginLe dossier skills/ d’un plugin installéTous les employés
Utilisateur<data>/user/skills/<name>/Tous les employés
Paquet d’employéskills/ dans un paquet d’employé installéCet employé uniquement
Appris<data>/learned/skills/<employee>/<name>/Cet employé uniquement

<data> correspond à ~/Library/Application Support/Nebo sur macOS, %APPDATA%\Nebo sur Windows et ~/.local/share/nebo sur Linux. La variable d'environnement NEBO_HOME le remplace. Quand un employé a son propre skill et un skill partagé du même nom, c'est son propre skill qui l'emporte.

Nebo surveille ces dossiers et recharge un skill modifié au bout d'une seconde. Pour désactiver un skill sans le supprimer, renommez son fichier en SKILL.md.disabled.

Les skills décrivent un travail, pas des outils. Construisez un skill autour d'une responsabilité, comme le rapprochement des reçus, et laissez l'employé utiliser la connexion que le propriétaire a fournie. Quand un skill a vraiment besoin d'un plugin, déclarez-le avec le champ plugins.

Ensuite