NeboAI
NeboAI
Commencer

Référence SKILL.md

Cette page liste chaque élément d'un skill que Nebo lit : les champs du frontmatter, les variables qu'il remplace, les outils dont les employés se servent pour travailler avec les skills et l'environnement dans lequel s'exécutent les scripts.

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.

ChampTypePar défautSignification
namestringobligatoireIdentifiant. [a-z0-9-], sans trait d’union au début, à la fin ni doublé, 64 octets au maximum. Doit correspondre au nom du dossier.
descriptionstringobligatoireCe 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.
versionstring"1.0.0"Version sémantique. Vérifiée par les plages requires des autres skills. Mettez-la entre guillemets.
triggersliste 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.
platformliste de chaînestousmacos, linux, windows. Le skill ne se charge que là où l’un d’eux correspond.
capabilitiesliste de chaînes[]network et storage élargissent le bac à sable des scripts. Voir Bac à sable des scripts.
metadatamap{}Contient secrets et allowed_domains. Voir ci-dessous.
requiresliste 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.
pluginsliste de {name, version, optional}[]Plugins utilisés par ce skill. version vaut "*" par défaut, optional vaut false.
dependenciesliste de chaînes[]Noms courts des skills qui doivent être présents.
priorityinteger0Ordonne les skills dans les listes de gestion. N’influe pas sur le choix du skill par un employé.
authorstring""Enregistré pour l’affichage.
licensestring""Enregistré pour l’affichage.
compatibilitystring""Note libre, 500 octets au maximum.
tagsliste de chaînes[]Enregistré pour l’affichage.
allowed-toolsstring""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
keyNom de la variable d’environnement que reçoit le script. Obligatoire.
labelNom affiché au propriétaire.
hintOù obtenir la valeur.
requiredAvec 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.

VariableValeur
${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é.
$ARGUMENTSLes 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.

OutilParamètresCe qu’il fait
use_skillname, argsCharge 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_skillsqueryRenvoie jusqu’à 10 skills classés selon les correspondances avec le nom, les déclencheurs et la description.
read_skill_filename, pathLit un fichier du dossier du skill. Sans path, liste les fichiers et leur taille.
save_skillname, contentÉcrit un SKILL.md complet dans le dossier des skills utilisateur. Les skills de la boutique ne peuvent pas être écrasés.
delete_skillnameSupprime un skill utilisateur.
install_skillcodeInstalle un skill de la boutique à partir de son code d’installation SKIL-.
configure_skillname, key, valueDéfinit un secret. Sans key, indique ce dont le skill a besoin.
rate_skillname, rating, reviewNote un skill de la boutique de 1 à 5.
read_skill_reviewsnameLit les avis d’un skill de la boutique.
executeskill, script, args, timeoutExé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.

ScriptEnvironnement d’exécution
.pyPython, via le uv fourni avec Nebo s’il est présent, sinon python3.
.ts, .jsLe Bun fourni avec Nebo s’il est présent, sinon node.
bin/<file> ou binaryExécuté directement.
.shNon pris en charge.

Chaque exécution démarre avec un environnement vide et ces variables :

VariableValeur
SKILL_ARGSL’objet args en JSON.
Chaque key de secretLa valeur déchiffrée du secret.
<PLUGIN>_BINChemin 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é storage y ajoute le dossier de données de Nebo.
  • Il n'a aucun accès au réseau. La capacité network autorise les registres de paquets et les domaines listés dans metadata.allowed_domains.

Fichiers et limites

ÉlémentRègle
RessourcesTous les fichiers sauf SKILL.md, manifest.json, signatures.json et les fichiers cachés.
ExécutablesLes fichiers sous scripts/ ou bin/, et un fichier racine nommé binary.
CheminsRelatifs 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 skillsChaque 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.