NeboAI
NeboAI
Comenzar

Skills

Una skill le enseña a un empleado a hacer bien un tipo de trabajo. La escribes como una carpeta con un archivo SKILL.md: una descripción breve que el empleado usa para elegir la skill, e instrucciones que sigue una vez que la carga. Las skills no necesitan código, y todos los empleados de un bot pueden usarlas.

Qué es una skill

Una skill es una carpeta cuyo nombre coincide con el name de la skill. La carpeta contiene un archivo SKILL.md y, de forma opcional, cualquier otro archivo al que hagan referencia las instrucciones: documentos de referencia, plantillas o scripts.

SKILL.md tiene dos partes. El frontmatter YAML entre líneas --- lleva el nombre y una descripción. El cuerpo en Markdown que sigue lleva las instrucciones.

Cómo usan las skills los empleados

Un empleado trabaja con una skill en tres pasos.

  1. Elegir. En cada turno, el empleado ve una lista de las skills que tiene disponibles: el nombre de cada skill, su descripción y hasta tres de sus disparadores. La descripción es lo que el empleado lee para decidir, así que escríbela para que diga qué hace la skill y cuándo usarla.
  2. Cargar. El empleado llama a la herramienta use_skill con el nombre de la skill. La herramienta devuelve las instrucciones, la ruta de la carpeta de la skill y los nombres de sus archivos. Esta es la única forma en que un empleado lee una skill.
  3. Trabajar. El empleado sigue las instrucciones. Lee los archivos de apoyo con read_skill_file y ejecuta los scripts incluidos con execute.

Los disparadores nunca cargan una skill por sí solos. El empleado siempre decide. Cuando la lista crece, el empleado puede buscar en ella con find_skills.

Escribe tu primera skill

Crea una carpeta con el nombre de la skill, con un archivo dentro.

meeting-notes/
└── SKILL.md
---
name: meeting-notes
description: Turn a meeting transcript into decisions, action items with owners, and open questions. Use when someone shares meeting notes or a transcript.
---

# Meeting notes

1. List the decisions that were made.
2. List action items as "owner — task — due date".
3. List open questions that need a follow-up.

Keep each list short. If the transcript names no owner for an item, write "unassigned".

Pon la carpeta en el directorio de skills del usuario de un bot (consulta Dónde viven las skills). Nebo detecta la carpeta nueva en aproximadamente un segundo, y todos los empleados de ese bot pueden usar la skill.

Un empleado también puede escribir una skill por ti. Pídele que guarde una y llamará a save_skill, que escribe la carpeta en ese mismo directorio de skills del usuario.

Reglas que aplica el cargador

Una skill que rompe una de estas reglas no se carga. Nebo registra una advertencia y la omite.

ReglaDetalle
El archivo empieza con ---El frontmatter debe ser lo primero del archivo. El archivo debe estar en UTF-8.
name es obligatorioSolo letras minúsculas, dígitos y guiones; sin guion al inicio ni al final; sin guion doble; máximo 64 bytes.
description es obligatorioMáximo 1,024 bytes.
Los campos tienen el tipo correctoUn campo con el tipo YAML incorrecto invalida todo el archivo. Pon las versiones entre comillas, como "1.0.0".
platform coincideSi está presente, la skill solo se carga en los sistemas operativos indicados.

Las claves del frontmatter que Nebo no reconoce se ignoran. El cuerpo no tiene límite de tamaño, pero unas instrucciones más cortas dejan más espacio para el trabajo. Pasa el material largo a archivos que el empleado lea cuando los necesite.

Agregar archivos

Cualquier archivo de la carpeta que no sea SKILL.md ni un archivo oculto (dotfile) está disponible para el empleado. Los nombres de las carpetas los eliges tú; Nebo no les da un significado especial a references/ ni a assets/. Los archivos dentro de scripts/ o bin/ se pueden ejecutar.

invoice-check/
├── SKILL.md              # required
├── references/
│   └── policy.md         # read with read_skill_file
└── scripts/
    └── totals.py         # run with execute

Haz referencia a los archivos por su ruta dentro de la carpeta, como references/policy.md. El empleado los lee con read_skill_file, que rechaza cualquier ruta que salga de la carpeta. Los scripts se ejecutan con la herramienta execute en un sandbox. La referencia de SKILL.md explica los entornos de ejecución, las variables de entorno, los secretos y el acceso a la red.

Dónde viven las skills

Un bot reúne skills de varios lugares. Cuando dos fuentes ofrecen una skill con el mismo nombre, gana la fuente que aparece más abajo en esta lista.

FuenteUbicaciónQuién puede usarla
IncluidaIntegrada en NeboTodos los empleados
Tienda<data>/nebo/skills/<slug>/<version>/Todos los empleados
PluginLa carpeta skills/ de un plugin instaladoTodos los empleados
Usuario<data>/user/skills/<name>/Todos los empleados
Paquete de empleadoskills/ dentro de un paquete de empleado instaladoSolo ese empleado
Aprendida<data>/learned/skills/<employee>/<name>/Solo ese empleado

<data> es ~/Library/Application Support/Nebo en macOS, %APPDATA%\Nebo en Windows y ~/.local/share/nebo en Linux. La variable de entorno NEBO_HOME lo reemplaza. Cuando un empleado tiene su propia skill y una skill compartida con el mismo nombre, gana la suya.

Nebo vigila estas carpetas y vuelve a cargar una skill modificada después de un segundo. Para desactivar una skill sin borrarla, cambia el nombre de su archivo a SKILL.md.disabled.

Las skills describen trabajo, no herramientas. Escribe una skill en torno a una responsabilidad, como conciliar recibos, y deja que el empleado use la conexión que le haya dado el dueño. Cuando una skill de verdad necesite un plugin, decláralo con el campo plugins.

Siguiente