NeboAI
NeboAI
Empezar

Skills

Una skill 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 cargada. 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, si quieres, cualquier otro archivo al que remitan 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 los empleados las skills

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. La elección siempre la hace el empleado. 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 y 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 están 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 incumple una de estas reglas no se carga. Nebo registra una advertencia y la omite.

ReglaDetalle
El archivo empieza por ---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 inicial ni final; sin guion doble; como máximo 64 bytes.
description es obligatorioComo má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.

Añadir archivos

Cualquier archivo de la carpeta salvo SKILL.md y los archivos ocultos está disponible para el empleado. Los nombres de las carpetas los eliges tú; Nebo no da ningún significado especial a references/ ni a assets/. Los archivos 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 trata los entornos de ejecución, las variables de entorno, los secretos y el acceso a la red.

Dónde están las skills

Un bot reúne skills de varios sitios. Cuando dos fuentes ofrecen una skill con el mismo nombre, prevalece la fuente que aparece después en esta lista.

FuenteUbicaciónQuién puede usarla
IntegradaIntegrada 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 la sustituye. Cuando un empleado tiene una skill propia y una compartida con el mismo nombre, prevalece la suya.

Nebo vigila estas carpetas y recarga una skill modificada al cabo 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 propietario. Cuando una skill de verdad necesite un plugin, decláralo con el campo plugins.

Siguiente