Format du fichier
SKILL.md est un texte en UTF-8. Il commence par une ligne de trois traits d'union, puis le frontmatter YAML, puis une ligne de fermeture de trois traits d'union. Tout ce qui suit constitue le corps : les instructions Markdown que l'employé reçoit en chargeant le skill. Nebo trouve le fichier par son nom, sans tenir compte de la casse.
---
name: expense-review
description: Check submitted expenses against the company policy and flag anything that needs a receipt or an approval. Use when someone asks to review expenses or a reimbursement request.
version: "1.2.0"
author: Example Co
license: MIT
tags: [finance, expenses]
triggers: [reimbursement, expense report]
platform: [macos, linux, windows]
capabilities: [network]
metadata:
allowed_domains: [api.example.com]
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true
requires:
- name: receipt-capture
version: ">=1.0.0"
plugins:
- name: example-ledger
version: ">=2.0.0"
optional: true
---
# Expense review
Follow the policy in references/policy.md ... Champs du frontmatter
Seuls name et description sont obligatoires. Un champ avec un mauvais type fait échouer tout le fichier, et le skill ne se charge pas. Les clés non listées ici sont ignorées.
| Champ | Type | Par défaut | Signification |
|---|---|---|---|
name | string | obligatoire | Identifiant. [a-z0-9-], sans trait d’union au début, à la fin ni doublé, 64 octets au maximum. Doit correspondre au nom du dossier. |
description | string | obligatoire | Ce que fait le skill et quand l’utiliser. 1 024 octets au maximum. Affiché dans la liste des skills de l’employé et noté par find_skills. |
version | string | "1.0.0" | Version sémantique. Vérifiée par les plages requires des autres skills. Mettez-la entre guillemets. |
triggers | liste de chaînes | [] | Mots et expressions qui décrivent quand le skill s’applique. Jusqu’à trois apparaissent dans la liste des skills ; tous comptent dans find_skills. Ils ne chargent jamais un skill d’eux-mêmes. |
platform | liste de chaînes | tous | macos, linux, windows. Le skill ne se charge que là où l’un d’eux correspond. |
capabilities | liste de chaînes | [] | network et storage élargissent le bac à sable des scripts. Voir Bac à sable des scripts. |
metadata | map | {} | Contient secrets et allowed_domains. Voir ci-dessous. |
requires | liste de {name, version} | [] | Autres skills sur lesquels ce skill s’appuie. name est le nom court du skill ; version est une plage semver, "*" par défaut. |
plugins | liste de {name, version, optional} | [] | Plugins utilisés par ce skill. version vaut "*" par défaut, optional vaut false. |
dependencies | liste de chaînes | [] | Noms courts des skills qui doivent être présents. |
priority | integer | 0 | Ordonne les skills dans les listes de gestion. N’influe pas sur le choix du skill par un employé. |
author | string | "" | Enregistré pour l’affichage. |
license | string | "" | Enregistré pour l’affichage. |
compatibility | string | "" | Note libre, 500 octets au maximum. |
tags | liste de chaînes | [] | Enregistré pour l’affichage. |
allowed-tools | string | "" | Une chaîne de valeurs séparées par des espaces. Enregistrée ; non appliquée. |
Quand un skill cité dans requires ou dependencies est absent ou hors de la plage, ou qu'un plugin requis n'est pas installé, le skill se charge quand même et est marqué comme dégradé. Le propriétaire voit ce qui manque.
Secrets
Déclarez sous metadata.secrets les identifiants dont les scripts d'un skill ont besoin. Le propriétaire fournit les valeurs, et Nebo les stocke chiffrées pour ce skill.
metadata:
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true | Clé | Signification |
|---|---|
key | Nom de la variable d’environnement que reçoit le script. Obligatoire. |
label | Nom affiché au propriétaire. |
hint | Où obtenir la valeur. |
required | Avec true, execute refuse d’exécuter les scripts du skill tant que la valeur n’est pas définie. false par défaut. |
Un employé définit une valeur avec configure_skill. Vous pouvez faire référence à un secret dans le corps avec ${secret.KEY}, mais les scripts devraient plutôt lire la variable d'environnement.
Variables de modèle
Nebo remplace ces variables dans le corps quand un employé charge le skill. Elles ne sont pas remplacées dans les autres fichiers ; les scripts lisent plutôt des variables d'environnement.
| Variable | Valeur |
|---|---|
${NEBO_SKILL_DIR} | Chemin absolu du dossier du skill. |
${NEBO_DATA_DIR} | Un dossier accessible en écriture pour ce skill : <data>/appdata/skills/<name>. Créé à la première utilisation. |
${NEBO_USER_NAME} | Le nom du propriétaire. |
${NEBO_OS} | Le système d’exploitation. |
${NEBO_ARCH} | L’architecture du processeur. |
${plugin.SLUG_BIN} | Chemin du binaire d’un plugin déclaré. Le slug est mis en majuscules, les traits d’union devenant des tirets bas : example-ledger devient ${plugin.EXAMPLE_LEDGER_BIN}. |
${secret.KEY} | La valeur d’un secret déclaré. |
$ARGUMENTS | Les args transmis à use_skill. Quand le corps ne contient pas $ARGUMENTS, les arguments sont ajoutés à la suite. |
Outils de skill
Les employés travaillent avec les skills grâce à ces outils. use_skill est toujours disponible ; les autres se chargent quand un employé en a besoin.
| Outil | Paramètres | Ce qu’il fait |
|---|---|---|
use_skill | name, args | Charge un skill. Renvoie le corps développé, le chemin du dossier et les 20 premiers noms de fichiers. Réactive un skill désactivé. |
find_skills | query | Renvoie jusqu’à 10 skills classés selon les correspondances avec le nom, les déclencheurs et la description. |
read_skill_file | name, path | Lit un fichier du dossier du skill. Sans path, liste les fichiers et leur taille. |
save_skill | name, content | Écrit un SKILL.md complet dans le dossier des skills utilisateur. Les skills de la boutique ne peuvent pas être écrasés. |
delete_skill | name | Supprime un skill utilisateur. |
install_skill | code | Installe un skill de la boutique à partir de son code d’installation SKIL-. |
configure_skill | name, key, value | Définit un secret. Sans key, indique ce dont le skill a besoin. |
rate_skill | name, rating, review | Note un skill de la boutique de 1 à 5. |
read_skill_reviews | name | Lit les avis d’un skill de la boutique. |
execute | skill, script, args, timeout | Exécute un script du dossier d’un skill. Voir Bac à sable des scripts. |
Bac à sable des scripts
L'outil execute exécute un script du dossier d'un skill. Il choisit l'environnement d'exécution d'après le fichier.
| Script | Environnement d’exécution |
|---|---|
.py | Python, via le uv fourni avec Nebo s’il est présent, sinon python3. |
.ts, .js | Le Bun fourni avec Nebo s’il est présent, sinon node. |
bin/<file> ou binary | Exécuté directement. |
.sh | Non pris en charge. |
Chaque exécution démarre avec un environnement vide et ces variables :
| Variable | Valeur |
|---|---|
SKILL_ARGS | L’objet args en JSON. |
Chaque key de secret | La valeur déchiffrée du secret. |
<PLUGIN>_BIN | Chemin du binaire de chaque plugin déclaré. Les dossiers des plugins sont aussi ajoutés à PATH. |
import json, os
args = json.loads(os.environ.get("SKILL_ARGS", "{}"))
api_key = os.environ["EXAMPLE_API_KEY"]
print(json.dumps({"checked": len(args.get("items", []))})) Le script s'exécute dans une copie temporaire du dossier du skill, avec un délai d'expiration par défaut de 30 secondes. Sur macOS et Linux, il s'exécute dans un bac à sable du système d'exploitation :
- Il ne peut pas lire les magasins d'identifiants, les données du navigateur et du trousseau, ni les paramètres et la base de données de Nebo.
- Il ne peut écrire que dans son dossier de travail et dans
/tmp/nebo. La capacitéstoragey ajoute le dossier de données de Nebo. - Il n'a aucun accès au réseau. La capacité
networkautorise les registres de paquets et les domaines listés dansmetadata.allowed_domains.
Fichiers et limites
| Élément | Règle |
|---|---|
| Ressources | Tous les fichiers sauf SKILL.md, manifest.json, signatures.json et les fichiers cachés. |
| Exécutables | Les fichiers sous scripts/ ou bin/, et un fichier racine nommé binary. |
| Chemins | Relatifs au dossier du skill. Les chemins contenant .. ou qui sortent du dossier sont refusés. |
| Skill désactivé | Un dossier contenant SKILL.md.disabled au lieu de SKILL.md. |
| Liste des skills | Chaque entrée est coupée à 250 caractères. Quand la liste entière dépasse 8 000 caractères, les skills partagés sont raccourcis en premier ; les skills propres à un employé gardent leur entrée complète. |
Les limites des fichiers que vous publiez sur la boutique figurent sur la page Publication.