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.
- 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.
- Cargar. El empleado llama a la herramienta
use_skillcon 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. - Trabajar. El empleado sigue las instrucciones. Lee los archivos de apoyo con
read_skill_filey ejecuta los scripts incluidos conexecute.
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.
| Regla | Detalle |
|---|---|
El archivo empieza con --- | El frontmatter debe ser lo primero del archivo. El archivo debe estar en UTF-8. |
name es obligatorio | Solo letras minúsculas, dígitos y guiones; sin guion al inicio ni al final; sin guion doble; máximo 64 bytes. |
description es obligatorio | Máximo 1,024 bytes. |
| Los campos tienen el tipo correcto | Un campo con el tipo YAML incorrecto invalida todo el archivo. Pon las versiones entre comillas, como "1.0.0". |
platform coincide | Si 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.
| Fuente | Ubicación | Quién puede usarla |
|---|---|---|
| Incluida | Integrada en Nebo | Todos los empleados |
| Tienda | <data>/nebo/skills/<slug>/<version>/ | Todos los empleados |
| Plugin | La carpeta skills/ de un plugin instalado | Todos los empleados |
| Usuario | <data>/user/skills/<name>/ | Todos los empleados |
| Paquete de empleado | skills/ dentro de un paquete de empleado instalado | Solo 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
- Referencia de SKILL.md: cada campo, herramienta y variable.
- Ejemplos: skills completas para copiar.
- Publicación: pon una skill en la tienda.