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.
| Campo | Tipo | Por defecto | Significado |
|---|---|---|---|
name | string | obligatorio | Identificador. [a-z0-9-], sin guion inicial, final ni doble, como máximo 64 bytes. Debe coincidir con el nombre de la carpeta. |
description | string | obligatorio | Qué 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. |
version | string | "1.0.0" | Versión semántica. La comprueban los rangos requires de otras skills. Ponla entre comillas. |
triggers | lista 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. |
platform | lista de cadenas | todos | macos, linux, windows. La skill solo se carga donde haya coincidencia. |
capabilities | lista de cadenas | [] | network y storage amplían el sandbox de scripts. Consulta Sandbox de scripts. |
metadata | map | {} | Contiene secrets y allowed_domains. Consulta más abajo. |
requires | lista 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. |
plugins | lista de {name, version, optional} | [] | Plugins que usa esta skill. version vale "*" por defecto; optional, false. |
dependencies | lista de cadenas | [] | Nombres cortos de las skills que deben estar presentes. |
priority | integer | 0 | Ordena las skills en las listas de gestión. No influye en qué skill elige un empleado. |
author | string | "" | Se guarda para mostrarlo. |
license | string | "" | Se guarda para mostrarlo. |
compatibility | string | "" | Nota de texto libre, de 500 bytes como máximo. |
tags | lista de cadenas | [] | Se guarda para mostrarlo. |
allowed-tools | string | "" | 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 | Clave | Significado |
|---|---|
key | Nombre de la variable de entorno que recibe el script. Obligatorio. |
label | Nombre que se muestra al propietario. |
hint | Dónde conseguir el valor. |
required | Si 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.
| Variable | Valor |
|---|---|
${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. |
$ARGUMENTS | Los 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.
| Herramienta | Parámetros | Qué hace |
|---|---|---|
use_skill | name, args | Carga 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_skills | query | Devuelve hasta 10 skills ordenadas por coincidencias en el nombre, los disparadores y la descripción. |
read_skill_file | name, path | Lee un archivo de la carpeta de la skill. Sin path, muestra los archivos y su tamaño. |
save_skill | name, content | Escribe un SKILL.md completo en la carpeta de skills del usuario. Las skills de la tienda no se pueden sobrescribir. |
delete_skill | name | Elimina una skill del usuario. |
install_skill | code | Instala una skill de la tienda a partir de su código de instalación SKIL-. |
configure_skill | name, key, value | Define un secreto. Sin key, muestra lo que necesita la skill. |
rate_skill | name, rating, review | Valora una skill de la tienda de 1 a 5. |
read_skill_reviews | name | Lee las reseñas de una skill de la tienda. |
execute | skill, script, args, timeout | Ejecuta 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.
| Script | Entorno de ejecución |
|---|---|
.py | Python, mediante el uv incluido con Nebo si está disponible; si no, python3. |
.ts, .js | El Bun incluido con Nebo si está disponible; si no, node. |
bin/<file> o binary | Se ejecuta directamente. |
.sh | No compatible. |
Cada ejecución empieza con un entorno vacío y estas variables:
| Variable | Valor |
|---|---|
SKILL_ARGS | El objeto args como JSON. |
Cada key de secreto | El valor descifrado del secreto. |
<PLUGIN>_BIN | Ruta 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 capacidadstorageañade la carpeta de datos de Nebo. - No tiene acceso a la red. La capacidad
networkpermite los registros de paquetes y los dominios indicados enmetadata.allowed_domains.
Archivos y límites
| Elemento | Regla |
|---|---|
| Recursos | Todos los archivos salvo SKILL.md, manifest.json, signatures.json y los archivos ocultos. |
| Ejecutables | Los archivos de scripts/ o bin/, y un archivo en la raíz llamado binary. |
| Rutas | Relativas a la carpeta de la skill. Se rechazan las rutas con .. o que salen de la carpeta. |
| Skill desactivada | Una carpeta con SKILL.md.disabled en lugar de SKILL.md. |
| Lista de skills | Cada 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.