NeboAI
NeboAI
Empezar

Referencia de SKILL.md

Esta página recoge cada parte de una skill que Nebo lee: los campos del frontmatter, las variables que expande, las herramientas que usan los empleados para trabajar con skills y el entorno en el que se ejecutan los scripts.

Formato del archivo

SKILL.md es texto UTF-8. Empieza con una línea de tres guiones, sigue con el frontmatter YAML y termina con otra línea de tres guiones. Todo lo que viene después es el cuerpo: instrucciones en Markdown que el empleado recibe al cargar la skill. Nebo encuentra el archivo por su nombre sin distinguir mayúsculas y minúsculas.

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

Campos del frontmatter

Solo name y description son obligatorios. Un campo con el tipo incorrecto invalida todo el archivo, así que la skill no se carga. Las claves que no aparecen aquí se ignoran.

CampoTipoPor defectoSignificado
namestringobligatorioIdentificador. [a-z0-9-], sin guion inicial, final ni doble, como máximo 64 bytes. Debe coincidir con el nombre de la carpeta.
descriptionstringobligatorioQué hace la skill y cuándo usarla. Como máximo 1.024 bytes. Se muestra en la lista de skills del empleado y la puntúa find_skills.
versionstring"1.0.0"Versión semántica. La comprueban los rangos requires de otras skills. Ponla entre comillas.
triggerslista de cadenas[]Palabras y frases que describen cuándo se aplica la skill. Hasta tres aparecen en la lista de skills; todas cuentan en find_skills. Nunca cargan una skill por sí solas.
platformlista de cadenastodosmacos, linux, windows. La skill solo se carga donde haya coincidencia.
capabilitieslista de cadenas[]network y storage amplían el sandbox de scripts. Consulta Sandbox de scripts.
metadatamap{}Contiene secrets y allowed_domains. Consulta más abajo.
requireslista de {name, version}[]Otras skills en las que se basa esta. name es el nombre corto de la skill; version es un rango semver, "*" por defecto.
pluginslista de {name, version, optional}[]Plugins que usa esta skill. version vale "*" por defecto; optional, false.
dependencieslista de cadenas[]Nombres cortos de las skills que deben estar presentes.
priorityinteger0Ordena las skills en las listas de gestión. No influye en qué skill elige un empleado.
authorstring""Se guarda para mostrarlo.
licensestring""Se guarda para mostrarlo.
compatibilitystring""Nota de texto libre, de 500 bytes como máximo.
tagslista de cadenas[]Se guarda para mostrarlo.
allowed-toolsstring""Una cadena separada por espacios. Se guarda; no se aplica.

Cuando falta una skill indicada en requires o dependencies, o está fuera del rango, o no está instalado un plugin obligatorio, la skill se carga igualmente y se marca como degradada. El propietario ve qué falta.

Secretos

Declara las credenciales que necesitan los scripts de una skill en metadata.secrets. El propietario aporta los valores y Nebo los guarda cifrados para esa skill.

metadata:
  secrets:
    - key: EXAMPLE_API_KEY
      label: Example API key
      hint: Create one at https://example.com/settings/keys
      required: true
ClaveSignificado
keyNombre de la variable de entorno que recibe el script. Obligatorio.
labelNombre que se muestra al propietario.
hintDónde conseguir el valor.
requiredSi es true, execute se niega a ejecutar los scripts de la skill hasta que se define el valor. false por defecto.

Un empleado fija un valor con configure_skill. Puedes hacer referencia a un secreto en el cuerpo como ${secret.KEY}, aunque los scripts deberían leer la variable de entorno.

Variables de plantilla

Nebo sustituye estas variables en el cuerpo cuando un empleado carga la skill. No se sustituyen dentro de otros archivos; los scripts leen variables de entorno en su lugar.

VariableValor
${NEBO_SKILL_DIR}Ruta absoluta de la carpeta de la skill.
${NEBO_DATA_DIR}Una carpeta con permiso de escritura para esta skill: <data>/appdata/skills/<name>. Se crea la primera vez que se usa.
${NEBO_USER_NAME}El nombre del propietario.
${NEBO_OS}El sistema operativo.
${NEBO_ARCH}La arquitectura del procesador.
${plugin.SLUG_BIN}Ruta del binario de un plugin declarado. El slug va en mayúsculas, con los guiones cambiados por guiones bajos: example-ledger pasa a ser ${plugin.EXAMPLE_LEDGER_BIN}.
${secret.KEY}El valor de un secreto declarado.
$ARGUMENTSLos args que se pasan a use_skill. Si el cuerpo no tiene $ARGUMENTS, los argumentos se añaden al final.

Herramientas de skills

Los empleados trabajan con skills mediante estas herramientas. use_skill está siempre disponible; las demás se cargan cuando un empleado las necesita.

HerramientaParámetrosQué hace
use_skillname, argsCarga una skill. Devuelve el cuerpo expandido, la ruta de la carpeta y los 20 primeros nombres de archivo. Vuelve a activar una skill desactivada.
find_skillsqueryDevuelve hasta 10 skills ordenadas por coincidencias en el nombre, los disparadores y la descripción.
read_skill_filename, pathLee un archivo de la carpeta de la skill. Sin path, muestra los archivos y su tamaño.
save_skillname, contentEscribe un SKILL.md completo en la carpeta de skills del usuario. Las skills de la tienda no se pueden sobrescribir.
delete_skillnameElimina una skill del usuario.
install_skillcodeInstala una skill de la tienda a partir de su código de instalación SKIL-.
configure_skillname, key, valueDefine un secreto. Sin key, muestra lo que necesita la skill.
rate_skillname, rating, reviewValora una skill de la tienda de 1 a 5.
read_skill_reviewsnameLee las reseñas de una skill de la tienda.
executeskill, script, args, timeoutEjecuta un script de la carpeta de una skill. Consulta Sandbox de scripts.

Sandbox de scripts

La herramienta execute ejecuta un script de la carpeta de una skill. Elige el entorno de ejecución según el archivo.

ScriptEntorno de ejecución
.pyPython, mediante el uv incluido con Nebo si está disponible; si no, python3.
.ts, .jsEl Bun incluido con Nebo si está disponible; si no, node.
bin/<file> o binarySe ejecuta directamente.
.shNo compatible.

Cada ejecución empieza con un entorno vacío y estas variables:

VariableValor
SKILL_ARGSEl objeto args como JSON.
Cada key de secretoEl valor descifrado del secreto.
<PLUGIN>_BINRuta del binario de cada plugin declarado. Las carpetas de los plugins también se añaden a 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", []))}))

El script se ejecuta en una copia temporal de la carpeta de la skill, con un tiempo de espera por defecto de 30 segundos. En macOS y Linux se ejecuta en un sandbox del sistema operativo:

  • No puede leer almacenes de credenciales, datos del navegador ni del llavero, ni la configuración y la base de datos de Nebo.
  • Solo puede escribir en su carpeta de trabajo y en /tmp/nebo. La capacidad storage añade la carpeta de datos de Nebo.
  • No tiene acceso a la red. La capacidad network permite los registros de paquetes y los dominios indicados en metadata.allowed_domains.

Archivos y límites

ElementoRegla
RecursosTodos los archivos salvo SKILL.md, manifest.json, signatures.json y los archivos ocultos.
EjecutablesLos archivos de scripts/ o bin/, y un archivo en la raíz llamado binary.
RutasRelativas a la carpeta de la skill. Se rechazan las rutas con .. o que salen de la carpeta.
Skill desactivadaUna carpeta con SKILL.md.disabled en lugar de SKILL.md.
Lista de skillsCada entrada se corta a los 250 caracteres. Cuando la lista completa supera los 8.000 caracteres, primero se acortan las skills compartidas; las skills propias de un empleado conservan sus entradas completas.

Los límites de los archivos que publicas en la tienda están en la página de Publicación.