NeboAI
NeboAI
Comenzar

Referencia de SKILL.md

Esta página enumera 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, 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.

CampoTipoPredeterminadoSignificado
namestringobligatorioIdentificador. [a-z0-9-], sin guion al inicio, al final ni doble, máximo 64 bytes. Debe coincidir con el nombre de la carpeta.
descriptionstringobligatorioQué 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.
versionstring"1.0.0"Versión semántica. La verifican los rangos de requires de otras skills. Ponla entre comillas.
triggerslista 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.
platformlista de cadenastodasmacos, 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 skill. name es el nombre corto de la skill; version es un rango semver, predeterminado "*".
pluginslista de {name, version, optional}[]Plugins que usa esta skill. version toma "*" de forma predeterminada; optional, false.
dependencieslista de cadenas[]Nombres cortos de las skills que deben estar presentes.
priorityinteger0Ordena las skills en las listas de administración. No influye en qué skill elige un empleado.
authorstring""Se guarda para mostrarse.
licensestring""Se guarda para mostrarse.
compatibilitystring""Nota de texto libre, de 500 bytes como máximo.
tagslista de cadenas[]Se guarda para mostrarse.
allowed-toolsstring""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
ClaveSignificado
keyNombre de la variable de entorno que recibe el script. Obligatorio.
labelNombre que se le muestra al dueño.
hintDónde obtener el valor.
requiredCuando 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.

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

HerramientaParámetrosQué hace
use_skillname, argsCarga 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_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, enumera los archivos y sus tamaños.
save_skillname, contentEscribe un SKILL.md completo en la carpeta de skills del usuario. Las skills de la tienda no se pueden sobrescribir.
delete_skillnameBorra 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, reviewCalifica una skill de la tienda del 1 al 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 cuando está presente; si no, python3.
.ts, .jsEl Bun incluido con Nebo cuando está presente; 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 del secreto descifrado.
<PLUGIN>_BINRuta 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 capacidad storage agrega la carpeta de datos de Nebo.
  • No tiene acceso a la red. La capacidad network permite los registros de paquetes y los dominios que aparecen en metadata.allowed_domains.

Archivos y límites

ElementoRegla
RecursosTodos los archivos excepto SKILL.md, manifest.json, signatures.json y los archivos ocultos (dotfiles).
EjecutablesLos archivos dentro 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 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.