Formato del archivo
SKILL.md es texto UTF-8. Empieza con una línea de tres guiones, luego el frontmatter YAML y después una línea de cierre de tres guiones. Todo lo que sigue es el cuerpo: las instrucciones en Markdown que recibe el empleado cuando carga la skill. Nebo encuentra el archivo por su nombre sin distinguir mayúsculas de 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 | Predeterminado | Significado |
|---|---|---|---|
name | string | obligatorio | Identificador. [a-z0-9-], sin guion al inicio, al final ni doble, máximo 64 bytes. Debe coincidir con el nombre de la carpeta. |
description | string | obligatorio | Qué hace la skill y cuándo usarla. Máximo 1,024 bytes. Se muestra en la lista de skills del empleado y find_skills la puntúa. |
version | string | "1.0.0" | Versión semántica. La verifican los rangos de requires de otras skills. Ponla entre comillas. |
triggers | lista de cadenas | [] | Palabras y frases que describen cuándo 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 | todas | 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 skill. name es el nombre corto de la skill; version es un rango semver, predeterminado "*". |
plugins | lista de {name, version, optional} | [] | Plugins que usa esta skill. version toma "*" de forma predeterminada; 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 administración. No influye en qué skill elige un empleado. |
author | string | "" | Se guarda para mostrarse. |
license | string | "" | Se guarda para mostrarse. |
compatibility | string | "" | Nota de texto libre, de 500 bytes como máximo. |
tags | lista de cadenas | [] | Se guarda para mostrarse. |
allowed-tools | string | "" | Una cadena separada por espacios. Se guarda; no se aplica. |
Cuando falta una skill nombrada en requires o dependencies, o está fuera del rango, o no está instalado un plugin requerido, la skill igual se carga y queda marcada como degradada. El dueño ve qué falta.
Secretos
Declara las credenciales que necesitan los scripts de una skill en metadata.secrets. El dueño proporciona 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 le muestra al dueño. |
hint | Dónde obtener el valor. |
required | Cuando es true, execute se niega a ejecutar los scripts de la skill hasta que se define el valor. Predeterminado false. |
Un empleado define 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 reemplaza estas variables en el cuerpo cuando un empleado carga la skill. No se reemplazan 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 dueño. |
${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 guiones como guiones bajos: example-ledger se convierte en ${plugin.EXAMPLE_LEDGER_BIN}. |
${secret.KEY} | El valor de un secreto declarado. |
$ARGUMENTS | Los args que se pasan a use_skill. Cuando el cuerpo no tiene $ARGUMENTS, los argumentos se agregan al final. |
Herramientas de skills
Los empleados trabajan con skills mediante estas herramientas. use_skill siempre está 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 primeros 20 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, enumera los archivos y sus tamaños. |
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 | Borra 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 | Califica una skill de la tienda del 1 al 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 cuando está presente; si no, python3. |
.ts, .js | El Bun incluido con Nebo cuando está presente; 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 del secreto descifrado. |
<PLUGIN>_BIN | Ruta del binario de cada plugin declarado. Las carpetas de los plugins también se agregan 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 predeterminado 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 propias de Nebo.
- Solo puede escribir en su carpeta de trabajo y en
/tmp/nebo. La capacidadstorageagrega la carpeta de datos de Nebo. - No tiene acceso a la red. La capacidad
networkpermite los registros de paquetes y los dominios que aparecen enmetadata.allowed_domains.
Archivos y límites
| Elemento | Regla |
|---|---|
| Recursos | Todos los archivos excepto SKILL.md, manifest.json, signatures.json y los archivos ocultos (dotfiles). |
| Ejecutables | Los archivos dentro 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 toda la lista 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 Publicación.